List calendars you can create events in

GET

/calendars/selectable

const url = 'https://calendar.work.optidata.cloud/api/calendars/selectable';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://calendar.work.optidata.cloud/api/calendars/selectable \
  --header 'Authorization: Bearer <token>'

The subset of GET /calendars the caller may create events in — that is, the calendars where their role is manager, admin or owner. Returned as id/label pairs, which is all a calendar picker needs.

Authorizations

bearerAuth

Responses

200

Calendars the caller can write events to.

application/json

object

calendars

required

Array<object>

object

required

Calendar id.

string

text

required

Display name.

string

Examples

selectable

{
  "calendars": [
    {
      "id": "10",
      "text": "Calendar"
    },
    {
      "id": "454",
      "text": "Team planning"
    },
    {
      "id": "1233",
      "text": "Meeting room"
    }
  ]
}

401

Missing, malformed or expired authentication key.

application/json

Authentication failures use an error key rather than message.

object

error

required

string

Examples

missing

No bearer token sent

{
  "error": "JWT passport exception: Missing bearer token in request"
}

429

Rate limit exceeded. Retry after the window resets.

application/json

Generic error envelope used by policy, binding and framework failures.

object

message

required

Human-readable description of the failure.

string

Examples

throttled

{
  "message": "Too Many Attempts."
}