Update Custom Agent V1

Update fields on a custom agent. Empty PATCH (no fields) returns 422.

PATCH /api/v1/custom-agents/{agent_id}

cURL

curl --request PATCH \
  --url 'https://api.computer.stateset.app/api/v1/custom-agents/{agent_id}' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Two-Person Tent",
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "system_prompt_extension": "string",
  "skills": [
    "string"
  ],
  "tool_permissions": [
    "string"
  ],
  "default_params": {},
  "trigger_config": {},
  "is_active": true
}'

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Two-Person Tent",
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "system_prompt_extension": "string",
  "agent_type": "string",
  "skills": [
    "string"
  ],
  "tool_permissions": [
    "string"
  ],
  "default_params": {},
  "trigger_config": {},
  "is_active": true,
  "is_sandbox": true,
  "created_at": "2026-08-31T14:22:05Z",
  "updated_at": "2026-08-31T14:22:05Z"
}

Update fields on a custom agent. Empty PATCH (no fields) returns 422.

Path parameters

agent_id · string (uuid) · required

Request body

CustomAgentUpdateRequest

name · string,null

description · string,null

system_prompt_extension · string,null

skills · string[],null

tool_permissions · string[],null

default_params · object,null

trigger_config · object,null

is_active · boolean,null

Response

CustomAgentSummary

id · string · required

name · string · required

description · string,null · required

system_prompt_extension · string,null · required

agent_type · string · required

skills · string[] · required

tool_permissions · string[] · required

default_params · object · required

trigger_config · object · required

is_active · boolean · required

is_sandbox · boolean · required

created_at · string · required

updated_at · string · required

Status codes

Code	Meaning
200	Successful Response
422	Validation Error

cURL

curl --request PATCH \
  --url 'https://api.computer.stateset.app/api/v1/custom-agents/{agent_id}' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Two-Person Tent",
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "system_prompt_extension": "string",
  "skills": [
    "string"
  ],
  "tool_permissions": [
    "string"
  ],
  "default_params": {},
  "trigger_config": {},
  "is_active": true
}'

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Two-Person Tent",
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "system_prompt_extension": "string",
  "agent_type": "string",
  "skills": [
    "string"
  ],
  "tool_permissions": [
    "string"
  ],
  "default_params": {},
  "trigger_config": {},
  "is_active": true,
  "is_sandbox": true,
  "created_at": "2026-08-31T14:22:05Z",
  "updated_at": "2026-08-31T14:22:05Z"
}