SMAO API Documentation
Public APICalendars

Delete a calendar

DELETE
/calendars/{calendar_id}

Deletes a calendar. Fails with 409 conflict if the calendar is still assigned to one or more assistants or a website widget's availability uses it - unlink it from every assistant first (via the Assistants endpoint) and from the widget in the dashboard, then retry. Also returns 409 while the organization is busy with a conflicting change such as its deletion.

Authorization

bearerAuth
AuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the SMAO dashboard (Settings → API Keys).

In: header

Path Parameters

calendar_id*string
Match^[a-f0-9]{24}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/calendars/65f8fa6f1a9d8e0012ab34cd"
{  "data": {}}

Update a calendar PATCH

Partial update - only included fields are changed. Passing `schedules` replaces the calendar's full schedules array.

List tools GET

Returns the organization's custom tools, ordered by `created_at` DESC. Auth configuration is summarized - the stored secret value is never returned; `auth.has_secret` indicates whether a credential is set.