Retrieve an agent

Retrieves a single agent configuration by ID. Requires agents:read.

Use this to inspect instructions, active/inactive availability, and runtime settings for one agent. Archived agents return 404.

GET/agents/{agentId}

Authorization

AuthorizationBearer <token>

Path parameters

agentIdstringrequired

format: "uuid"

Response

application/json

Agent object.

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 GET \
  --url 'https://YOUR_SALAMBO_BASE_URL/api/v1/agents/{agentId}' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Replace placeholders with your values.

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
}