Get agent soul

Get the agent’s soul document (base personality / system prompt). Stored as SOUL.md in the agent workspace.

GET /api/captain/agents/{id}/soul

Get agent soul

cURL

curl --request GET \
  --url http://localhost:63372/api/captain/agents/{id}/soul \
  --cookie captain_session=

200

{
  "agent_id": "meepa",
  "path": "~/.meepagateway/agents/meepa/SOUL.md",
  "content": "# Meepa\n\nYou are Meepa, a helpful bot assistant.\n"
}

Authorizations

cookieAuthbearerAuth

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

200

application/json

Soul document

agent_id · string · required

Example:

"meepa"

path · string · required

Example:

"~/.meepagateway/agents/meepa/SOUL.md"

content · string · required

Example:

"# Meepa\n\nYou are Meepa, a helpful bot assistant.\n"