Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

Authorization-code grant with PKCE S256, exact scopes, explicit resource audience and a persisted consent grant. Obtain endpoint URLs from server discovery in the target environment. Refresh tokens remain client-bound.

FlowAuthorization Code
Authorization URL
/oauth/authorize
Token URL
/oauth/token
Refresh URL
/oauth/token
Scopes1
calendar:read
Read calendar and slots.

Path Parameters

profile_id
string<uuid>
required

Profile UUID; must be in the grant allowlist and currently accessible to the actor.

Query Parameters

start
string<date-time>

Inclusive RFC3339 timestamp with UTC offset. Supply together with end. If both are omitted, the configured default window is used.

RFC3339 timestamp with an explicit UTC offset.

end
string<date-time>

Exclusive RFC3339 timestamp with UTC offset. Supply together with start. End must be after start and within the configured maximum range (at most 366 days). A window containing more than the configured maximum slots (at most 100) returns 422 calendar_range_too_dense.

RFC3339 timestamp with an explicit UTC offset.

Response

Calendar and slots, or structured absence.

data
object
required

When exists is false, only exists and profile_id are emitted.

Example:
meta
object
required