0
Fork 0
mirror of https://github.com/project-zot/zot.git synced 2024-12-16 21:56:37 -05:00
zot/pkg/extensions/userprefs.md
LaurentiuNiculae 2b8479f7f2
feat(userprefs): update documentation and list extensions endpoint (#1456)
Signed-off-by: Laurentiu Niculae <niculae.laurentiu1@gmail.com>
2023-05-25 14:46:52 +03:00

1.4 KiB

userprefs

userprefs component provides an endpoint for adding user preferences for repos. It is available only to authentificated users. Unauthentificated users will be denied access.

Supported queries Input Output Description
Toggle repo star None None Sets the repo starred property to true if it is false, and to false if it is true
Toggle repo bookmark None None Sets the repo bookmarked property to true if it is false, and to false if it is true

General usage

The userprefs endpoint accepts as a query parameter what action to perform and then all other required parameters for the specified action.

Toggle repo star

Action Parameter Parameter Type Parameter Description
toggleStar repo string The repo name which should be starred

A request to togle a star on a repo would look like this:

(PUT) http://localhost:8080/v2/_zot/ext/userprefs?action=toggleStar&repo=repoName

Toggle repo bookmark

Action Parameter Parameter Type Parameter Description
toggleBookmark repo string The repo name which should be bookmarked

A request to togle a bookmark on a repo would look like this:

(PUT) http://localhost:8080/v2/_zot/ext/userprefs?action=toggleBookmark&repo=repoName