Update an agent

Updates core agent fields such as name, description, instructions, and active/inactive availability. Requires agents:write.

Updating configuration is separate from runtime execution. For current product behavior, isActive is the public callability switch: inactive agents do not appear as models, while active agents can be called once a ready deployment and billing prerequisites are available. Archived agents return 404 and cannot be reactivated.

PATCH/agents/{agentId}

Authorization

AuthorizationBearer <token>

Path parameters

agentIdstringrequired

format: "uuid"

Bodyrequired

application/json

object

minProperties: 1

Additional properties are not allowed.

namestring

minLength: 1
maxLength: 100

descriptionstring | null

maxLength: 500

iconstring | null

maxLength: 10

commandContentstring

isActiveboolean

Public active/inactive switch.

Response

application/json

Updated agent.

object

idstringrequired

format: "uuid"

public_idstringrequired

pattern: "^agt_[A-Za-z0-9]+$"

objectstringrequired

const: "agent"

namestringrequired

slugstringrequired

descriptionstring | null

iconstring | null

command_contentstring

is_activebooleanrequired

Public active/inactive switch. Active agents can appear in the model list.

created_atintegerrequired

updated_atintegerrequired

curl --request PATCH \
  --url 'https://YOUR_SALAMBO_BASE_URL/api/v1/agents/{agentId}' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '@request.json'

Replace placeholders before running. JSON templates without a sample body read your payload from request.json.

Response

{
  "id": "<string>",
  "public_id": "<string>",
  "object": "agent",
  "name": "<string>",
  "slug": "<string>",
  "description": "<string | null>",
  "icon": "<string | null>",
  "command_content": "<string>",
  "is_active": true,
  "created_at": 123,
  "updated_at": 123
}