SMAO API Documentation
Public APICalendars

Update a calendar

PATCH
/calendars/{calendar_id}

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

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Partial update - include only the fields you want to change. Passing schedules replaces the full schedules array for this calendar.

Properties1 <= properties

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/calendars/65f8fa6f1a9d8e0012ab34cd" \  -H "Content-Type: application/json" \  -d '{    "name": "Main Office Berlin"  }'
{  "data": {    "id": "string",    "name": "string",    "timezone": "string",    "schedules": [      {        "id": "string",        "type": "opening_hours",        "weekly_schedule": {          "mon": {            "is_open": true,            "slots": [              {                "from": "string",                "to": "string"              }            ]          },          "tue": {            "is_open": true,            "slots": [              {                "from": "string",                "to": "string"              }            ]          },          "wed": {            "is_open": true,            "slots": [              {                "from": "string",                "to": "string"              }            ]          },          "thu": {            "is_open": true,            "slots": [              {                "from": "string",                "to": "string"              }            ]          },          "fri": {            "is_open": true,            "slots": [              {                "from": "string",                "to": "string"              }            ]          },          "sat": {            "is_open": true,            "slots": [              {                "from": "string",                "to": "string"              }            ]          },          "sun": {            "is_open": true,            "slots": [              {                "from": "string",                "to": "string"              }            ]          }        },        "overrides": [          {            "date": "string",            "type": "closed",            "reason": "string",            "slots": [              {                "from": "string",                "to": "string"              }            ]          }        ]      }    ],    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  }}

Get a calendar GET

Get a calendar

Delete a calendar DELETE

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.