API Reference
Account
Read and update your account profile, subscription plan, and connected channel status.
Get account profile
GET /api/v1/account
Returns your client account details.
curl https://dashboard.skylightchat.com/api/v1/account \
-H "Authorization: Bearer sk_live_••••••••••••"
Response
{
"success": true,
"data": {
"id": 12,
"name": "Acme Corp",
"email": "admin@acmecorp.com",
"timezone": "America/New_York",
"locale": "en",
"status": "active",
"created_at": "2025-06-01T10:00:00.000000Z"
}
}
Update account profile
PATCH /api/v1/account
Update your account name, timezone, or locale.
Request body
{
"name": "Acme Corp International",
"timezone": "Europe/London",
"locale": "en"
}
| Field | Type | Description |
|---|---|---|
name | string | Account display name |
timezone | string | IANA timezone (e.g., America/New_York) |
locale | string | Language code: en, ar |
Response
{
"success": true,
"data": {
"id": 12,
"name": "Acme Corp International",
"timezone": "Europe/London",
"locale": "en"
},
"message": "Account updated successfully."
}
Get subscription details
GET /api/v1/account/subscription
Returns your current plan, limits, and feature flags.
curl https://dashboard.skylightchat.com/api/v1/account/subscription \
-H "Authorization: Bearer sk_live_••••••••••••"
Response
{
"success": true,
"data": {
"plan": {
"id": 3,
"name": "Business",
"slug": "business"
},
"status": "active",
"expires_at": "2027-03-01T00:00:00.000000Z",
"limits": {
"contacts": { "max": 10000, "used": 4238 },
"team_members": { "max": 10, "used": 4 },
"messages_per_month": { "max": 50000, "used": 12800 }
},
"features": {
"webhooks": true,
"api_access": true,
"booking": true,
"omni_channel": true,
"advanced_analytics": true
}
}
}
Get connected channels
GET /api/v1/account/channels
Returns the connection status for each messaging channel.
curl https://dashboard.skylightchat.com/api/v1/account/channels \
-H "Authorization: Bearer sk_live_••••••••••••"
Response
{
"success": true,
"data": [
{
"id": 1,
"type": "whatsapp",
"name": "Acme Support",
"username": "+14155551000",
"is_connected": true,
"status": "active",
"last_synced_at": "2026-01-10T08:00:00Z"
},
{
"id": 2,
"type": "telegram",
"name": "Acme Bot",
"username": "@AcmeSupport",
"is_connected": true,
"status": "active",
"last_synced_at": "2026-02-01T09:30:00Z"
},
{
"id": 3,
"type": "instagram",
"name": null,
"username": null,
"is_connected": false,
"status": "inactive",
"last_synced_at": null
}
]
}
| Field | Type | Description |
|---|---|---|
id | integer | Channel setting ID |
type | string | Channel identifier: whatsapp, telegram, instagram |
name | string|null | Display name configured for this channel |
username | string|null | Account username or phone number |
is_connected | boolean | Whether the channel is actively connected |
status | string | active or inactive |
last_synced_at | string|null | ISO 8601 timestamp of last sync |