{"openapi":"3.1.0","info":{"title":"Cal.com Organization (BYOK) API","version":"0.1.0","description":"Cal.com Organization (BYOK) lets an AI assistant read your own Cal.com Organization data through the Cal.com Organization API with a key you supply (Cal.com API key of an organization admin (starts with cal_live_)). Read-only: 9 tools (list_org_teams, get_org_team, list_org_team_event_types, list_attributes, list_attribute_options, list_roles, list_org_routing_forms, list_org_webhooks,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-cal-com-organization.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-cal-com-organization/docs"},"termsOfService":"https://connectorbay.com/byok-cal-com-organization/terms"},"servers":[{"url":"https://byok-cal-com-organization.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-cal-com-organization/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_org_teams":{"post":{"operationId":"list_org_teams","summary":"List the teams of the organization: name, slug, bio, privacy flag, time zone and week start. Needs an organization admin","description":"List the teams of the organization: name, slug, bio, privacy flag, time zone and week start. Needs an organization admin key. Use for \"Which teams does my Cal.com organization have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"Numeric id of your Cal.com organization.","title":"Org Id","type":"integer"},"take":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":250,"description":"How many items to return (1 to 250).","title":"Take"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many items to skip, for paging.","title":"Skip"}},"required":["org_id"],"title":"list_org_teamsArguments","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_org_team":{"post":{"operationId":"get_org_team","summary":"Get one team of the organization by id: name, slug, bio, privacy flag, time zone and week start. Use for \"Show Cal.com o","description":"Get one team of the organization by id: name, slug, bio, privacy flag, time zone and week start. Use for \"Show Cal.com organization team 12\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"Numeric id of your Cal.com organization.","title":"Org Id","type":"integer"},"team_id":{"description":"Numeric id of the team (from list_org_teams).","title":"Team Id","type":"integer"}},"required":["org_id","team_id"],"title":"get_org_teamArguments","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_org_team_event_types":{"post":{"operationId":"list_org_team_event_types","summary":"List the event types of all teams in the organization: title, slug, length, scheduling type, team id and booking link. U","description":"List the event types of all teams in the organization: title, slug, length, scheduling type, team id and booking link. Use for \"What team event types exist across my Cal.com organization\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"Numeric id of your Cal.com organization.","title":"Org Id","type":"integer"},"take":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":250,"description":"How many items to return (1 to 250).","title":"Take"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many items to skip, for paging.","title":"Skip"},"sort_created_at":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Order by creation date: asc or desc.","title":"Sort Created At"}},"required":["org_id"],"title":"list_org_team_event_typesArguments","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_attributes":{"post":{"operationId":"list_attributes","summary":"List the member attributes defined for the organization (name, slug, type, enabled flag). Definitions only, not which me","description":"List the member attributes defined for the organization (name, slug, type, enabled flag). Definitions only, not which member has which value. Use for \"What member attributes are defined in my Cal.com organization\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"Numeric id of your Cal.com organization.","title":"Org Id","type":"integer"},"take":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":250,"description":"How many items to return (1 to 250).","title":"Take"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many items to skip, for paging.","title":"Skip"}},"required":["org_id"],"title":"list_attributesArguments","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_attribute_options":{"post":{"operationId":"list_attribute_options","summary":"List the selectable options of one organization attribute (value and slug). Use for \"What options does the Cal.com attri","description":"List the selectable options of one organization attribute (value and slug). Use for \"What options does the Cal.com attribute a1 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"Numeric id of your Cal.com organization.","title":"Org Id","type":"integer"},"attribute_id":{"description":"Attribute id (from list_attributes).","maxLength":80,"title":"Attribute Id","type":"string"}},"required":["org_id","attribute_id"],"title":"list_attribute_optionsArguments","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_roles":{"post":{"operationId":"list_roles","summary":"List the roles of the organization with name, type (system or custom), colour, description and permissions. Needs an org","description":"List the roles of the organization with name, type (system or custom), colour, description and permissions. Needs an organization admin key. Use for \"What roles exist in my Cal.com organization\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"Numeric id of your Cal.com organization.","title":"Org Id","type":"integer"},"take":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":250,"description":"How many items to return (1 to 250).","title":"Take"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many items to skip, for paging.","title":"Skip"}},"required":["org_id"],"title":"list_rolesArguments","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_org_routing_forms":{"post":{"operationId":"list_org_routing_forms","summary":"List the organization's routing form definitions (name, description, team, disabled flag, field definitions). Form defin","description":"List the organization's routing form definitions (name, description, team, disabled flag, field definitions). Form definitions only; responses are not read. Use for \"What routing forms does my Cal.com organization have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"Numeric id of your Cal.com organization.","title":"Org Id","type":"integer"},"take":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many forms to return.","title":"Take"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many forms to skip.","title":"Skip"},"sort_created_at":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Order by creation time: asc or desc.","title":"Sort Created At"}},"required":["org_id"],"title":"list_org_routing_formsArguments","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_org_webhooks":{"post":{"operationId":"list_org_webhooks","summary":"List the organization-level webhooks: subscriber URL, triggers, active flag and team. The signing secret is not returned","description":"List the organization-level webhooks: subscriber URL, triggers, active flag and team. The signing secret is not returned by this tool. Use for \"Which webhooks are set up for my Cal.com organization\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"Numeric id of your Cal.com organization.","title":"Org Id","type":"integer"},"take":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":250,"description":"How many items to return (1 to 250).","title":"Take"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many items to skip, for paging.","title":"Skip"}},"required":["org_id"],"title":"list_org_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}},"/v1/tools/list_secondary_domains":{"post":{"operationId":"list_secondary_domains","summary":"List the organization's secondary email domains with verification state. Use for \"Which secondary domains does my Cal.co","description":"List the organization's secondary email domains with verification state. Use for \"Which secondary domains does my Cal.com organization have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"Numeric id of your Cal.com organization.","title":"Org Id","type":"integer"}},"required":["org_id"],"title":"list_secondary_domainsArguments","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}}}}