Update Client Workspace

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
  }'

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
    })
  }
);

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

PATCH

agency

clients

{client_id}

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
  }'

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
    })
  }
);

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

Available on agency plans. The API token must belong to the agency owner. Only the fields you send are changed. Two common flows:

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.

Limits apply from the next message or source the client uses. Message credits also reset automatically at the start of each calendar month.

Path Parameters

Name	Type	Description
client_id*	String	The ID of the client workspace.

Headers

Name	Type	Description
Accept*	String	application/json
Authorization*	String	Bearer
Content-Type*	String	application/json
Idempotency-Key	String	Optional. When set, retrying with the same key and body returns the original response.

Body Parameters

Name	Type	Description
name	String	The client workspace name.
external_reference	String	Your own identifier for this client. Send `null` to clear it.
message_limit	Integer	Monthly message credit limit. Send `null` to remove the client-level limit.
source_limit	Integer	Source limit. Send `null` to remove the client-level limit.
chatbot_limit	Integer	Maximum number of AI agents. Send `null` to remove the client-level limit.
reset_credits	Boolean	When `true`, the client’s usage counter restarts now and their remaining credits become the full `message_limit` (or the existing limit when `message_limit` is omitted). Use for mid-cycle plan changes.

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
  }'

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
    })
  }
);

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

Response

Returns the updated client workspace. After a credit reset, credits_reset_at holds the reset time and usage.messages starts again from 0.

200 Success
403 Not an agency account
404 Not found
422 Validation error

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

Last modified on July 22, 2026

Get Client Workspace List Client AI Agents

Overview

Agency

Chatbot

Analytics

Conversation History

Updated Answers

Leads

Suggested Messages

Query

Sources

User

Path Parameters

Headers

Body Parameters

Response

​Path Parameters

​Headers

​Body Parameters

​Response

Path Parameters

Headers

Body Parameters

Response