{"openapi":"3.1.0","info":{"title":"Cal.com Availability (BYOK) API","version":"0.1.0","description":"Cal.com Availability (BYOK) lets an AI assistant read your own Cal.com Availability data through the Cal.com Availability API with a key you supply (Cal.com API key (starts with cal_live_)). Read-only: 7 tools (list_schedules, get_default_schedule, get_schedule, get_my_profile, list_conferencing_apps, get_default_conferencing_app, list_webhooks). The BYOK key travels with each request, is used...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-cal-com-availability.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-cal-com-availability/docs"},"termsOfService":"https://connectorbay.com/byok-cal-com-availability/terms"},"servers":[{"url":"https://byok-cal-com-availability.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-cal-com-availability/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_schedules":{"post":{"operationId":"list_schedules","summary":"List your availability schedules: name, time zone, default flag, weekly working-hour windows and date overrides. Use for","description":"List your availability schedules: name, time zone, default flag, weekly working-hour windows and date overrides. Use for \"What availability schedules do I have in Cal.com\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_schedulesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_default_schedule":{"post":{"operationId":"get_default_schedule","summary":"Get your default availability schedule with weekly windows and date overrides. Use for \"What are my default working hour","description":"Get your default availability schedule with weekly windows and date overrides. Use for \"What are my default working hours in Cal.com\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_default_scheduleArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_schedule":{"post":{"operationId":"get_schedule","summary":"Get one availability schedule by id with weekly windows and date overrides. Use for \"Show my Cal.com schedule 1\".","description":"Get one availability schedule by id with weekly windows and date overrides. Use for \"Show my Cal.com schedule 1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"schedule_id":{"description":"Numeric schedule id from list_schedules, for example 1.","title":"Schedule Id","type":"integer"}},"required":["schedule_id"],"title":"get_scheduleArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_my_profile":{"post":{"operationId":"get_my_profile","summary":"Show the profile settings of the key's account that affect scheduling: username, name, time zone, week start, time forma","description":"Show the profile settings of the key's account that affect scheduling: username, name, time zone, week start, time format and default schedule id (e-mail is not returned). Use for \"Which Cal.com time zone and default schedule is my account using\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_my_profileArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_conferencing_apps":{"post":{"operationId":"list_conferencing_apps","summary":"List the conferencing apps connected to your account with credential id, app type and whether the connection is invalid.","description":"List the conferencing apps connected to your account with credential id, app type and whether the connection is invalid. Use for \"Which video conferencing apps are connected to my Cal.com account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_conferencing_appsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_default_conferencing_app":{"post":{"operationId":"get_default_conferencing_app","summary":"Get the default conferencing app slug and its link used for new bookings. Use for \"What is my default Cal.com conferenci","description":"Get the default conferencing app slug and its link used for new bookings. Use for \"What is my default Cal.com conferencing app\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_default_conferencing_appArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_webhooks":{"post":{"operationId":"list_webhooks","summary":"List the webhooks of your account with id, active flag, subscribed triggers and owner. The target URL, secret and payloa","description":"List the webhooks of your account with id, active flag, subscribed triggers and owner. The target URL, secret and payload template are not returned. Use for \"Which Cal.com webhooks are active on my account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"take":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many webhooks to return (1 to 250).","title":"Take"},"skip":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many webhooks to skip, for paging.","title":"Skip"}},"title":"list_webhooksArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}