AGagentarea
v1
protected
registries

Create Workspace Registry

Changed on
post/v1/workspaces/{workspace}/workspace-registries

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Path parameters

workspacestring required

Slug of the workspace the request acts in

Request body

credentials_secret_idstring uuid nullable

A workspace secret holding the token a private source is read with

descriptionstring nullable
mode'mirror' | 'upstream'

'mirror' stores every skill's content when the registry syncs, so an install needs no network; 'upstream' fetches it on first install. A source read with credentials is mirrored.

namestring required
registry_type'skills' | 'agents'
source_pathstring nullable

GitHub: the folder whose skill folders are indexed; the root if unset

source_refstring nullable

GitHub: branch, tag or commit; the default branch if unset

source_type'url' | 'github' required

'url': an index in the platform format; 'github': a repository

source_urlstring required

The index URL, or the repository as owner/repo

trust'private' | 'community'

Response

Successful Response

created_atstring date-time required
credentials_secret_idstring uuid nullable
descriptionstring nullable required
idstring uuid required
is_activeboolean required
item_countinteger required
last_sync_errorstring nullable required
last_synced_atstring date-time nullable required
mode'mirror' | 'upstream' required
namestring required
recommendation_priorityinteger required
registry_typestring required
scope'platform' | 'workspace' required
source_pathstring nullable
source_refstring nullable
source_typestring required
source_urlstring required
trust'official' | 'verified' | 'community' | 'private' required
updated_atstring date-time required
workspace_idstring nullable

Changes