AGagentarea
v1
protected
registries

Create Registry

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

Request

Path parameters

workspacestring required

Slug of the workspace the request acts in

Request body

descriptionstring nullable
mode'mirror' | 'upstream'

'mirror' copies content at sync; 'upstream' keeps only the index

namestring required

Human-readable registry name

recommendation_priorityinteger nullable

Ordering weight for the 'recommended' catalog sort; lower comes first. Keeps a curated system catalog ahead of a bulk/community mirror. Omit to take the platform default.

registry_typestring required

Catalog entity type: one of ('mcp_servers', 'skills', 'llm_providers', 'llm_models', 'agents', 'bundles', 'source_types')

source_pathstring nullable

GitHub sources: the folder whose skill folders are indexed

source_refstring nullable

GitHub sources: branch, tag or commit to read

source_typestring required

Source mode: 'url', 'github', 'api', or platform-managed 'managed'

source_urlstring nullable

Registry source URL; omitted when source_type is 'managed'

trust'official' | 'verified' | 'community' | 'private'

Trust label on every catalog card

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

  • 2dff4ebbb4ebRevision changes
    • breaking

      removed the required property from the response with the status

    • warning

      removed the request property

  • 32e3ecc10543Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status