Skip to main content
GET
/
api
/
captain
/
agents
/
{id}
Get agent
curl --request GET \
  --url http://localhost:63372/api/captain/agents/{id} \
  --cookie captain_session=
{
  "id": "meepa",
  "name": "Meepa",
  "default": true,
  "workspace": "./agents/meepa",
  "provider": "anthropic",
  "model": null,
  "sandbox": null,
  "tools": null,
  "max_iterations": null,
  "connectors": [
    {
      "name": "meepachat",
      "type": "meepachat",
      "meepachat": {
        "url": "wss://chat.example.com/api/bot-gateway",
        "bot_token": "bot.secret"
      },
      "discord": {
        "bot_token": "discord-bot-token",
        "guild_ids": []
      }
    }
  ],
  "mcp_servers": [
    {
      "name": "filesystem",
      "enabled": true,
      "transport": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/tmp"
      ],
      "url": null,
      "env": {}
    }
  ]
}

Authorizations

​
captain_session
string
cookie
required

HMAC-signed session cookie returned by /api/captain/auth/login. Valid for 7 days. Invalidated when password changes.

Path Parameters

​
id
string
required

Agent ID

Response

Agent detail

​
id
string
required
Example:

"meepa"

​
name
string
required
Example:

"Meepa"

​
default
boolean | null
Example:

true

​
workspace
string | null
Example:

"./agents/meepa"

​
provider
string | null
Example:

"anthropic"

​
model
string | null
Example:

null

​
sandbox
string | null
Example:

null

​
tools
string[] | null
Example:

null

​
max_iterations
integer | null
Example:

null

​
connectors
object[]
​
mcp_servers
object[]