Skip to main content
POST
Disconnect Calendly
Requires Admin or Owner. Send no request body. The workspace context identifies the connection to disconnect.
Disconnecting disables Calendly tools for agents in this workspace. A request already in progress may still finish.
Removes saved tokens and pending authorization and returns state: "not-connected". Non-secret account information, the cached catalog, and the tool link remain for repair. Repeating the request leaves the connection disconnected. This does not revoke the application’s authorization at Calendly or cancel existing meetings. To revoke provider authorization too, remove the app in Calendly. Reconnecting the same account restores the existing tool link; a different account receives a separate link and must be selected again by agents.

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.