v2

latestOpenAPI 3.1.0Proprietary2026-07-26127193620.1 KB

Registries

Publish an agent into a registry

post/registries/{slug}/agents

Headers

Idempotency-Keystring

Optional client-supplied idempotency key. Retrying a request with the same key returns the original result instead of performing the action a second time; if omitted the server derives one from the canonical payload hash. Safe to retry network failures without duplicating side effects.

Request body

addressstring required

handlestring required

The registry-scoped name to list the agent under.

display_namestring

Present to define the agent identity before publishing (define + publish in one call).

endpoint_idstring uuid

Optional, only used when defining. Omit to resolve the endpoint from the address's routing.

titlestring nullable

descriptionstring nullable

tagsstring[]

Response

Idempotent replay of an existing publication

successtrue required