v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-275867561.6 MB

agents

Get an agent

Returns the specified agent: its metadata (name, description, permissions, runtime, extras) plus the parsed file tree (system prompt, tools, subagents, skills) at the latest commit. Pass include_files=true to also receive the raw file map.

Responses include system_prompt and instructions with the same value; instructions is deprecated.

get/v1/fleet/agents/{agent_id}

Path parameters

agent_idstring uuid required

Agent ID

Query parameters

include_filesboolean

Include the raw file map in the response

Response

access_level'READ' | 'RUN' | 'WRITE'

created_atstring date-time

descriptionstring

extrasobject

filesobject

Raw file map. Returned only when include_files=true.

idstring uuid

instructionsstring

Deprecated: use system_prompt. Echoed alongside system_prompt with the same value for backwards compatibility.

is_ownerboolean

namestring

owner_idstring uuid

revisionstring

system_promptstring

Agent system prompt parsed from AGENTS.md.

updated_atstring date-time

Example response

{
  "backend": {
    "sandbox": {
      "delete_after_stop_seconds": 1200,
      "idle_ttl_seconds": 600,
      "snapshot_id": "550e8400-e29b-41d4-a716-446655440000"
    },
    "type": "thread_scoped_sandbox"
  },
  "runtime": {
    "model": {
      "model_id": "claude-sonnet-4-6"
    }
  },
  "skills": [
    {
      "description": "Summarise text into a paragraph.",
      "instructions": "# Summarize\n\nGiven a text, produce a one-paragraph summary.",
      "name": "summarize",
      "type": "inline"
    }
  ],
  "subagents": [
    {
      "description": "Researches a topic and summarises findings.",
      "instructions": "You are a research assistant. Use the available tools to gather information.",
      "model_id": "claude-sonnet-4-6",
      "name": "researcher",
      "tools": {
        "tools": [
          {
            "display_name": "read_url_content",
            "mcp_server_name": "Fleet",
            "mcp_server_url": "https://tools.example.com",
            "name": "read_url_content"
          }
        ]
      }
    }
  ],
  "tools": {
    "tools": [
      {
        "display_name": "read_url_content",
        "mcp_server_name": "Fleet",
        "mcp_server_url": "https://tools.example.com",
        "name": "read_url_content"
      }
    ]
  }
}