Skip to main content
POST
/
agent
/
v1
/
agents
Create agent
curl --request POST \
  --url https://api.case.dev/agent/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "instructions": "<string>",
  "description": "<string>",
  "model": "<string>",
  "vaultIds": [
    "<string>"
  ],
  "enabledTools": [
    "<string>"
  ],
  "disabledTools": [
    "<string>"
  ],
  "sandbox": {
    "cpu": 123,
    "memoryMiB": 123
  }
}
'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "instructions": "<string>",
  "model": "<string>",
  "vaultIds": [
    "<string>"
  ],
  "enabledTools": [
    "<string>"
  ],
  "disabledTools": [
    "<string>"
  ],
  "sandbox": {},
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization
string
header
required

API key starting with sk_case_

Body

application/json
name
string
required

Display name for the agent

instructions
string
required

System instructions that define agent behavior

description
string

Optional description of the agent

model
string

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

vaultIds
string[] | null

Restrict agent to specific vault IDs

enabledTools
string[] | null

Allowlist of tools the agent can use

disabledTools
string[] | null

Denylist of tools the agent cannot use

sandbox
object

Custom sandbox configuration (cpu, memoryMiB)

Response

Agent created

id
string
name
string
description
string | null
instructions
string
model
string
vaultIds
string[] | null
enabledTools
string[] | null
disabledTools
string[] | null
sandbox
object
createdAt
string<date-time>
updatedAt
string<date-time>