ClientSphereDocs
API reference/Widgets

Get widget

Fetches a single chat widget by its id, including the configuration the embed script reads.

GET
/widgets/{id}

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token: Authorization: Bearer sk_live_.... Use sk_live_ prefixed keys for production data and sk_test_ prefixed keys for sandbox/test data.

In: header

X-API-Key<token>

API key via header: X-API-Key: sk_live_.... Use sk_live_ prefixed keys for production data and sk_test_ prefixed keys for sandbox/test data.

In: header

Path Parameters

idRequiredstring

Resource ID

Format: "uuid"
curl -X GET "https://clientsphere.io/api/v1/widgets/497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -H "Authorization: Bearer <token>"

Widget details

{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",
    "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",
    "name": "string",
    "isActive": true,
    "primaryColor": "#3B82F6",
    "accentColor": "#1E40AF",
    "welcomeMessage": "string",
    "placeholderText": "string",
    "position": "bottom-right",
    "showAgentPhotos": true,
    "showTypingIndicator": true,
    "requireEmail": true,
    "collectVisitorInfo": true,
    "businessHours": {},
    "offlineMessage": "string",
    "aiAutoRespond": true,
    "aiAssistantName": "string",
    "aiWelcomeMessage": "string",
    "totalConversations": 0,
    "totalMessages": 0,
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
}

Previous

List widgets GET

Next

Create widget POST