Check calendar setup

GET
/v1/calendar/status

Says whether a calendar is connected and working, and whether anything needs the person to sign in again or approve one more permission. Start here when something calendar-related fails. Each connection carries a plain needs sentence with the link to open when it needs the person.

Requires an API key with the calendar:use scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Response Body

Each connected calendar and whether it needs the person

application/json
  1. response
connections*array<>
summary*string
Example Request
curl https://api.vlayers.ai/v1/calendar/status \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "connections": [    {      "id": "0192f5c0-1a2b-7c3d-8e4f-5a6b7c8d9e01",      "app": "Google Calendar",      "account": "[email protected]",      "working": true,      "needs": null,      "canMakeAgentCalendar": true    }  ],  "summary": "Google Calendar ([email protected]): working."}