Create an agent
Authorizations
Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.
Headers
Optional external end-user identifier forwarded by the API gateway.
Body
1 - 1201"functionary-pt"
200020000Tool configuration for agent creation or update. Shell container_auto accepts network_policy with type 'allowlist' and up to 256 allowed_domains (DNS hostnames); an empty or omitted list denies all external hosts. This further restricts tenant and operator policies. Domain secrets, unknown policy fields, and changing a container_reference policy or memory-store mounts are rejected. Omit memory_stores on a reference to retain its existing mounts. computer_use_preview is unsupported. Historical agent responses and versions retain their original tool fields.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
Arbitrary JSON value.
1 <= x <= 300Ordered chain of model IDs the gateway tries when a model call fails on the model before it; forwarded unchanged to the Responses API, which validates it. Empty (the default) means the run keeps the gateway's own fallback rules for the model.
1Most runs of this agent that may execute at once. Null (the default) means no limit. Not part of the versioned configuration: a rollback keeps the current limit, and changing only this field or concurrency_overflow creates no new version.
1 <= x <= 1000What a run beyond max_concurrent_runs gets. reject (the default) refuses it with 429 and error code agent_concurrency_limit. queue stores it as waiting and starts it, oldest first, when a run finishes, with the agent configuration current at that time.
reject, queue Response
Agent created.
agent "functionary-pt"
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
Arbitrary JSON value.
1 <= x <= 1000reject, queue Current configuration version. Incremented on every update or rollback.
x >= 1Whether the deleted agent is within its pinned restoration deadline, independent of caller permission.
Whether the current caller has restoration permission within the pinned deadline.