Skip to main content
GET
Get Calendly connection
Requires workspace membership (Viewer or higher). Accepts a Labs API key with the workspace header, or a Labs OAuth bearer token using your selected workspace. Each workspace shares one connected Calendly account. This reads saved status and the cached tool catalog; it does not contact Calendly or refresh access. can_manage is true for Admins and Owners. Credentials are never returned. last_synced_at is a Unix timestamp in seconds, or null. Cached tools, tool_uuid, and account details can remain after disconnect or discovery failure; their presence does not mean the connection is usable. Inspect state first. The catalog reflects the connected account and is not a guarantee that every tool execution will be permitted.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Response

Successful Response

can_manage
boolean
required

Whether the caller is an Admin or Owner who can change this workspace connection.

state
enum<string>
required

Connection readiness. Inspect this field even after HTTP 200; cached tools may remain while the connection is unusable.

Available options:
not-connected,
connected,
reconnect-required,
discovery-failed
account_name
string | null

Connected account display name; may remain after disconnect.

integration_id
string | null

Workspace integration identifier, or null before a connection record exists.

last_synced_at
number | null

Unix timestamp in seconds of the last successful discovery, or null.

tool_uuid
string | null

Linked managed tool group UUID. Select its tools for agents explicitly.

tools
CalendlyTool · object[]

Cached provider tool catalog. Use only while state is connected; discovery is not permission to execute every tool.