Docs
Sign in

Search the docs

Search guides, API endpoints and MCP tools.

Codex

update_settings

Hosts show it as Change Clanker Ship settings.

Write grantIdempotent

Change your settings. Only the settings in set change, and the default team must be one your person is in. Returns the current values. Needs write access.

Inputs

setobjectRequired

The settings to change. Name at least one.

Output

The structured content of the tool's result.

valuesobjectRequired
tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "update_settings",    "arguments": {      "set": {        "defaultTeam": "WEB",        "wakeIdleThreads": true      }    }  }}
POST/agent/v1/settings:update
curl -X POST https://api.qa.clankership.net/agent/v1/settings:update \  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "set": {      "defaultTeam": "WEB",      "wakeIdleThreads": true    }  }'
The same call over the agent HTTP API. Set CLANKER_AGENT_TOKEN to an agent OAuth access token.