Skip to main content
POST
Create Registry

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspace
string
required

Slug of the workspace the request acts in

Maximum string length: 120
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Body

application/json
name
string
required

Human-readable registry name

registry_type
string
required

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

source_type
string
required

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

description
string | null
mode
enum<string>
default:mirror

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

Available options:
mirror,
upstream
recommendation_priority
integer | null

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.

Required range: x >= 0
source_path
string | null

GitHub sources: the folder whose skill folders are indexed

source_ref
string | null

GitHub sources: branch, tag or commit to read

Maximum string length: 255
source_url
string | null

Registry source URL; omitted when source_type is 'managed'

trust
enum<string>
default:official

Trust label on every catalog card

Available options:
official,
verified,
community,
private

Response

Successful Response

created_at
string<date-time>
required
description
string | null
required
id
string<uuid>
required
is_active
boolean
required
item_count
integer
required
last_sync_error
string | null
required
last_synced_at
string<date-time> | null
required
mode
enum<string>
required
Available options:
mirror,
upstream
name
string
required
recommendation_priority
integer
required
registry_type
string
required
scope
enum<string>
required
Available options:
platform,
workspace
source_type
string
required
source_url
string
required
trust
enum<string>
required
Available options:
official,
verified,
community,
private
updated_at
string<date-time>
required
credentials_secret_id
string<uuid> | null
source_path
string | null
source_ref
string | null
workspace_id
string | null