Update Client Workspace

• Raise credits mid-cycle: send a higher message_limit. The client keeps their usage and gains the difference.
• Plan change with a credit reset: send the new message_limit together with reset_credits: true. The client’s usage counter restarts immediately, so their remaining credits become the full new limit, up to your agency plan’s remaining monthly credits. Nothing carries over.
• Cap response length: send response_token_limit to bound how long the client’s AI agents’ answers can be. The agents are instructed to write complete answers that fit the budget, with a hard token cut as the backstop. Enforcement is approximate: the model targets the limit and gets a small allowance to finish its last sentence, so treat the value as a strong target, not an exact cutoff.
• Let a client use their own LLM keys: send byok_enabled: true. Their workspace administrators can then add API keys in their portal. Messages still count against the client’s credits. See Client API Keys (BYOK).

​

Path Parameters

​

Headers

​

Body Parameters

curl -X PATCH "https://api.sitespeak.ai/v1/agency/clients/{client_id}" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message_limit": 5000,
    "reset_credits": true,
    "response_token_limit": 500
  }'

const response = await fetch(
  'https://api.sitespeak.ai/v1/agency/clients/{client_id}',
  {
    method: 'PATCH',
    headers: {
      'Accept': 'application/json',
      'Authorization': 'Bearer YOUR_API_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      message_limit: 5000,
      reset_credits: true,
      response_token_limit: 500
    })
  }
);

const data = await response.json();
console.log(data);

​

Response

{
  "client": {
    "id": "dfcee2e1-3ace-41c6-9803-fb2b7c7cdfc7",
    "name": "Acme Inc",
    "external_reference": "billing-account-1001",
    "status": "active",
    "pause_mode": null,
    "paused_at": null,
    "byok_enabled": false,
    "limits": {
      "chatbots": 2,
      "sources": 50,
      "messages": 5000,
      "response_tokens": 500
    },
    "usage": {
      "chatbots": 1,
      "sources": 12,
      "messages": 0
    },
    "messages_remaining": 5000,
    "topup_credits_remaining": 0,
    "credits_exhausted_at": null,
    "credits_reset_at": "2026-07-22T19:32:46+00:00",
    "created_at": "2026-07-22T19:31:40+00:00"
  }
}