Get Agent

Retrieve a specific agent by ID

GET /v1/agents/

Retrieve a specific agent by its UUID.

Path Parameters

id · string · required

UUID of the agent to retrieve

Response

Returns the agent object.

id · string

UUID of the agent

name · string

Agent name

system_prompt · string

Base system prompt (before capability additions)

description · string

Optional description

default_model_id · string

UUID of default model (null if not set)

capabilities · array

Array of capability references. Each item can be a string or an object with ref and optional config.

status · string

Agent status: active or archived

created_at · string

ISO 8601 timestamp of creation

updated_at · string

ISO 8601 timestamp of last update

Example Request

curl http://localhost:9300/v1/agents/01933b5a-0000-7000-8000-000000000001

Example Response

{
  "id": "01933b5a-0000-7000-8000-000000000001",
  "name": "Research Assistant",
  "system_prompt": "You are a helpful research assistant with access to web search and file management.",
  "description": "General purpose research agent for information gathering and analysis",
  "default_model_id": "01933b5a-0000-7000-8000-000000000010",
  "capabilities": [
    "current_time",
    "web_fetch",
    {
      "ref": "session_file_system",
      "config": {
        "max_file_size": 10485760
      }
    }
  ],
  "status": "active",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:35:00Z"
}

Error Responses

• 404 Not Found - Agent with specified ID does not exist
• 500 Internal Server Error - Server error

The system_prompt returned here is the base prompt defined for the agent. At runtime, capability system prompts are prepended to this base prompt to form the final prompt sent to the LLM. Use the POST /v1/agents/preview endpoint to see the final computed prompt.