Replace full configuration

Replace the entire gateway configuration with a new GatewayConfig object.

PUT /api/captain/config

Replace full configuration

cURL

curl --request PUT \
  --url http://localhost:63372/api/captain/config \
  --header 'Content-Type: application/json' \
  --cookie captain_session= \
  --data '
{
  "providers": {},
  "cron": {},
  "captain": {},
  "agents": [
    {
      "id": "meepa",
      "name": "Meepa",
      "default": true,
      "workspace": "./agents/meepa",
      "provider": "anthropic",
      "model": "claude-sonnet-4-5-20250929",
      "max_iterations": 10
    }
  ]
}
'

200

{
  "ok": true
}

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.

Body

application/json

providers · object

cron · object

captain · object

agents · object[]

Show child attributes

Response

200

application/json

Success

ok · boolean · required

Example:

true