v44

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-05-192301780.0 KB
Agents

Create agent

Creates a new agent definition with a scoped API key. The agent can then be used to create and execute runs.

post/agent/v1/agents

Request body

namestring required

Display name for the agent

descriptionstring

Optional description of the agent

instructionsstring required

System instructions that define agent behavior

modelstring

LLM model identifier (e.g. anthropic/claude-sonnet-4.6). Defaults to anthropic/claude-sonnet-4.6

vaultIdsstring[] nullable

Restrict agent to specific vault IDs

vaultGroupsstring[] nullable

Restrict agent to vaults within specific vault group IDs

enabledToolsstring[] nullable

Allowlist of tools the agent can use. Mutually exclusive with disabledTools — set one or the other, not both.

disabledToolsstring[] nullable

Denylist of tools the agent cannot use. Mutually exclusive with enabledTools — set one or the other, not both.

Response

Agent created

idstring
namestring
descriptionstring nullable
instructionsstring
modelstring
vaultIdsstring[] nullable
enabledToolsstring[] nullable
disabledToolsstring[] nullable
sandboxobject nullable
createdAtstring date-time
updatedAtstring date-time