Skip to Content
SeyloDocs
API referenceAI assistant

Update AI assistant settings

POST
/api/v1/ai.updateSettings

Changes the assistant settings. anthropicApiKey stores a new key (sealed; null removes it); omitted fields keep their value. The key is checked with a cheap request before it is saved.

Needs settings.manage, which owners and admins hold. Not available to MCP clients or the assistant.

Authorization

cookieseylo_session<token>

Request Body

application/json
  1. body
enabled?boolean
anthropicApiKey?|null
routing?
monthlyBudgetUsd?|null
allowMembers?boolean

Response Body

Success.

application/json
  1. response
enabled*boolean
keySet*boolean
keyHint*string
routing*
monthlyBudgetUsd*|null
allowMembers*boolean
Example Request
curl -X POST 'https://example.com/api/v1/ai.updateSettings' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "enabled": true,  "keySet": true,  "keyHint": "string",  "routing": {    "mode": "auto",    "model": "haiku",    "allowOpus": true  },  "monthlyBudgetUsd": 0,  "allowMembers": true}

Get AI assistant settings GET

Returns whether the assistant is on, whether a key is stored, the model routing and the monthly budget. Needs `settings.view`, which owners and admins hold. Not available to MCP clients or the assistant.

Get AI usage and the projected bill GET

Returns token use and cost for a month (default the current one, UTC) by model, by day and by person, the budget, and the bill projected from the pace so far. Needs `settings.view`, which owners and admins hold. Not available to MCP clients or the assistant.