coss.comdocs

Get a calendar delegation

GET
/v1/scheduling/calendar_delegations/{id}

Its status, what to authorize, and how many hosts it has connected.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A secret API key from the dashboard: coss_live_… for production environments, coss_test_… for sandbox environments.

Path Parameters

id*string

The delegation's id.

Header Parameters

Coss-Version?"2026-10-10"

The API version (a date) to use for this request. Defaults to your organization's version, pinned to the latest one when it first used the API and upgraded from the dashboard. The SDK always sends the version it was built for.

Value in"2026-10-10"

Response Body

The delegation.

application/json
  1. response
object*"scheduling.calendar_delegation"
Value in"scheduling.calendar_delegation"
id*string
provider*string
Value in"google""microsoft"
domain*string
status*string

pending: not verified yet. failing: the provider refused access, and its hosts aren't offered until it's back. deleting: its connections are being removed.

Value in"pending""active""failing""deleting"
match_host_email*boolean
client_id*string

Google: the numeric client ID your Workspace admin authorizes.

tenant_id*string|null
scopes*array<string>

What to authorize: OAuth scopes in Google's Admin console, the application permission in Entra.

verified_account*string|null
last_error_code*string|null
failing_since*string|null
secret_expires_at*string|null
hosts_connected*integer
hosts_failed*integer

Hosts whose mailbox can't be reached, or who are out while this is failing.

created_at*string
updated_at*string
import { Coss } from "coss";const coss = new Coss({  apiKey: process.env.COSS_API_KEY,  baseUrl: "https://api.coss.com",});const { data, error } = await coss.scheduling.calendarDelegations.get("caldlg_01kd2m9a0b1c2d3e4f5g6h7j8m");
{  "object": "scheduling.calendar_delegation",  "id": "caldlg_01kd2m9a0b1c2d3e4f5g6h7j8m",  "provider": "google",  "domain": "example.com",  "status": "active",  "match_host_email": true,  "client_id": "117063284751902345678",  "tenant_id": null,  "scopes": [    "https://www.googleapis.com/auth/calendar.events.freebusy"  ],  "verified_account": "ana@example.com",  "last_error_code": null,  "failing_since": null,  "secret_expires_at": null,  "hosts_connected": 240,  "hosts_failed": 1,  "created_at": "2027-01-01T10:00:00.000Z",  "updated_at": "2027-01-01T10:00:00.000Z"}