Skip to main content
POST
Register an agent version

Authorizations

Authorization
string
header
required

Send Authorization: Bearer YOUR_API_KEY. The key resolves to a single organization.

Path Parameters

id
string<uuid>
required

Body

application/json
version
string
required

Case-sensitive release label after trimming whitespace. The draft: and generated: prefixes are reserved.

Required string length: 1 - 255
systemPrompt
string
Maximum string length: 200000
config
object

Complete version context as a JSON object, up to 64 KiB serialized as UTF-8. Can include llm, stt, tts, tools, workflows, retrieval, and custom settings. Records context only; does not deploy or execute this configuration. Do not include secrets.

Response

Identical version already registered.

id
string<uuid>
required
created
boolean
required