{"openapi":"3.1.0","info":{"title":"Calendly API (Bowmark)","version":"e833508f87ff","description":"Calendly's own public booking-widget data — find a person's Calendly page from their name, read the event types it offers, the questions its booking form asks, and the real, currently-open time slots — read straight off the widget's undocumented JSON endpoints, no browser, no key.\n\nEvery function Bowmark has for Calendly (calendly.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/calendly/getEventTypes":{"post":{"operationId":"getEventTypes","summary":"Lists every event type a Calendly profile currently offers — the entry point.","description":"Lists every event type a Calendly profile currently offers — the entry point. Takes the bare profile slug a person books under (e.g. \"jason-frazier\") or the full url a caller was given (e.g. \"https://calendly.com/jason-frazier\"), and returns each event's name, slug, uuid and its own bookable url.\n\nCalls `bowmark.providers.calendly.getEventTypes`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CalendlyEventTypesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"type":"string","description":"TypeScript: `string`"}},"required":["profile"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/calendly/getAvailability":{"post":{"operationId":"getAvailability","summary":"Returns the real, currently-open time slots for one Calendly event type — accepts a bare profile slug (\"jason-frazier\"), a profile url, a specific event url (\"https://calendly.com/jason-frazier/15min\"","description":"Returns the real, currently-open time slots for one Calendly event type — accepts a bare profile slug (\"jason-frazier\"), a profile url, a specific event url (\"https://calendly.com/jason-frazier/15min\"), or a one-off share link (\"https://calendly.com/d/<hash>\") or single-use link (\"https://calendly.com/s/<slug>\"). Given a bare profile, it picks that profile's first event type and reports the rest in `otherEventTypes`. `days` is empty both when nothing is open and when Calendly reports the calendar cannot be booked at all (a broken calendar connection, a deactivated event) — check `unavailableReason` to tell the two apart.\n\nCalls `bowmark.providers.calendly.getAvailability`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CalendlyAvailabilityResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"type":"string","description":"TypeScript: `string`"},"opts":{"$ref":"#/components/schemas/CalendlyAvailabilityOptions","description":"TypeScript: `CalendlyAvailabilityOptions`"}},"required":["profile"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/calendly/getBookingForm":{"post":{"operationId":"getBookingForm","summary":"Reads what a Calendly booking page will ask before anyone books: the owner's name, the event's name/description/duration, every custom form question (with its choices and whether it is required), the ","description":"Reads what a Calendly booking page will ask before anyone books: the owner's name, the event's name/description/duration, every custom form question (with its choices and whether it is required), the next open time, and Calendly's own reason when the calendar cannot be booked. Needs no open slot, so it reads a fully-booked calendar too. Takes a profile url (\"https://calendly.com/eric-ciarla\"), an event url, or a one-off share link (\"https://calendly.com/d/ctbt-d45-rgb/simbie-ai-demo\"). A profile with several events returns `event: null` and the list unless `opts.event` names one. Never books anything.\n\nCalls `bowmark.providers.calendly.getBookingForm`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CalendlyBookingForm>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"TypeScript: `string`"},"opts":{"$ref":"#/components/schemas/CalendlyBookingFormOptions","description":"TypeScript: `CalendlyBookingFormOptions`"}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/calendly/getBooking":{"post":{"operationId":"getBooking","summary":"Reads a booking from an invitee confirmation, cancellation or reschedule link that Calendly emails.","description":"Reads a booking from an invitee confirmation, cancellation or reschedule link that Calendly emails. Takes the full link a caller was sent (e.g. \"https://calendly.com/user/cancellations/<uuid>\") and returns the event details, invitee name and email, the booked time, and any cancellation reason if the booking has been cancelled.\n\nCalls `bowmark.providers.calendly.getBooking`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CalendlyBooking>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"link":{"type":"string","description":"TypeScript: `string`"}},"required":["link"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/calendly/bookMeeting":{"post":{"operationId":"bookMeeting","summary":"Books a slot on a Calendly event the way an invitee does: the event url (or a /d/ share link), a startTime exactly as getAvailability returned it, the invitee's name and email, and answers to the cust","description":"Books a slot on a Calendly event the way an invitee does: the event url (or a /d/ share link), a startTime exactly as getAvailability returned it, the invitee's name and email, and answers to the custom questions getBookingForm lists. Returns the booking with its cancel and reschedule links. Emails the host, so book only a slot you mean. Never pays for a paid event; reports when the host requires an SMS code.\n\nCalls `bowmark.providers.calendly.bookMeeting`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CalendlyBookMeetingResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/CalendlyBookMeetingArgs","description":"TypeScript: `CalendlyBookMeetingArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/calendly/rescheduleBooking":{"post":{"operationId":"rescheduleBooking","summary":"Moves a Calendly booking to a new slot the way its invitee does from the reschedule link: the link (or invitee uuid), the event url it was booked on, and a startTime exactly as getAvailability returne","description":"Moves a Calendly booking to a new slot the way its invitee does from the reschedule link: the link (or invitee uuid), the event url it was booked on, and a startTime exactly as getAvailability returned it. Keeps the invitee's name and email; answers to custom questions go in answers. Emails the host, so move only a booking you mean to. Refuses a cancelled booking.\n\nCalls `bowmark.providers.calendly.rescheduleBooking`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CalendlyBookMeetingResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/CalendlyRescheduleBookingArgs","description":"TypeScript: `CalendlyRescheduleBookingArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/calendly/cancelBooking":{"post":{"operationId":"cancelBooking","summary":"Cancels a Calendly booking the way its invitee does, from the cancel or reschedule link Calendly emailed (or the bare invitee uuid, e.g.","description":"Cancels a Calendly booking the way its invitee does, from the cancel or reschedule link Calendly emailed (or the bare invitee uuid, e.g. the one bookMeeting returns), with an optional reason. Emails the host, so cancel only a booking you mean to. Refuses a booking that is already cancelled.\n\nCalls `bowmark.providers.calendly.cancelBooking`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CalendlyCancelBookingResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/CalendlyCancelBookingArgs","description":"TypeScript: `CalendlyCancelBookingArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/calendly/getRoutingForm":{"post":{"operationId":"getRoutingForm","summary":"Reads a Calendly routing form, the questions an organization asks before it decides whose calendar you land on: its name, the organization behind it, each question with its type, choices and whether i","description":"Reads a Calendly routing form, the questions an organization asks before it decides whose calendar you land on: its name, the organization behind it, each question with its type, choices and whether it is required, and Calendly's own reason when it cannot be used. Takes the form uuid or any url carrying it (a \"request a demo\" page embeds \"calendly.com/api/form_builder/forms/<uuid>/submissions\"). A form that routes an external HubSpot or Marketo form has no questions of its own. Never submits anything.\n\nCalls `bowmark.providers.calendly.getRoutingForm`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CalendlyRoutingForm>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"form":{"type":"string","description":"TypeScript: `string`"}},"required":["form"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/calendly/submitRoutingForm":{"post":{"operationId":"submitRoutingForm","summary":"Answers a Calendly routing form the way its landing page does and returns where it sends you: the booking page or other url (`url`), or the organization's own thank-you message (`thankYou`).","description":"Answers a Calendly routing form the way its landing page does and returns where it sends you: the booking page or other url (`url`), or the organization's own thank-you message (`thankYou`). Takes { form, answers } where answers are keyed by the field id or the question's label from getRoutingForm; a missing required answer or a value outside a question's choices is refused before anything is sent. The submission lands in the organization's own records, so submit only a form you mean to answer. Never follows the returned url, and refuses a form that routes an external HubSpot or Marketo form.\n\nCalls `bowmark.providers.calendly.submitRoutingForm`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CalendlySubmitRoutingFormResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/CalendlySubmitRoutingFormArgs","description":"TypeScript: `CalendlySubmitRoutingFormArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/calendly/listPackages":{"post":{"operationId":"listPackages","summary":"Lists the prepaid session packages a Calendly profile sells (several meetings bought together, or a one-off payment link): name, description, price in the currency's major unit, how many sessions of w","description":"Lists the prepaid session packages a Calendly profile sells (several meetings bought together, or a one-off payment link): name, description, price in the currency's major unit, how many sessions of which event type, and the url where a person would buy it. Takes a profile slug or url (\"https://calendly.com/colleendelv\"). A profile that sells none returns `packages: []`. Never buys anything.\n\nCalls `bowmark.providers.calendly.listPackages`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CalendlyPackagesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"type":"string","description":"TypeScript: `string`"}},"required":["profile"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/calendly/findProfiles":{"post":{"operationId":"findProfiles","summary":"Finds a person's own Calendly page from their full name, and optionally their company (pass it — \"caleb-firecrawl\" is found only by the company shape).","description":"Finds a person's own Calendly page from their full name, and optionally their company (pass it — \"caleb-firecrawl\" is found only by the company shape). Checks the slug shapes that measured reliable (first-last, firstlast, lastfirst, first-company, firstcompany, last-company, and the bare company slug — which often belongs to a stranger, so read `ownerName`) and returns every one that exists with the name the page itself shows, `nameMatches`, the profile's own description and the names of the event types it offers (where a page names the company: \"Firecrawl-Introduction\"). A match is a GUESS: a namesake with the same first and last name passes, so tie the page to the company before relying on it. Search engines do not index Calendly pages, so this is the way to find one.\n\nCalls `bowmark.providers.calendly.findProfiles`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CalendlyFindProfilesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"TypeScript: `string`"},"company":{"type":"string","description":"TypeScript: `string`"}},"required":["name"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/calendly/signup":{"post":{"operationId":"signup","summary":"Makes a NEW Calendly account with the person's own email and password, in a session.","description":"Makes a NEW Calendly account with the person's own email and password, in a session. Pauses with `needs_code` / `needs_phone` whenever the site wants something only the person has; continue with `confirmSignup` in the same session. Ends `signed_up` with the login saved and the credentials in the person's secrets.\n\nCalls `bowmark.providers.calendly.signup`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ status: \"needs_code\"; channel: \"email\" | \"sms\"; sentTo?: string } | { status: \"needs_phone\" } | { status: \"in_progress\"; retryAfterSeconds: number } | { status: \"signed_up\"; username: string; email: string; connection: string | null; twoFactor: \"enrolled\" | \"none\"; secrets: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"description":"TypeScript: `SignupInput`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/calendly/confirmSignup":{"post":{"operationId":"confirmSignup","summary":"Continues the sign-up `signup` started in this session with the emailed or texted `code`, the email's verification `link`, or the person's `phone`.","description":"Continues the sign-up `signup` started in this session with the emailed or texted `code`, the email's verification `link`, or the person's `phone`.\n\nCalls `bowmark.providers.calendly.confirmSignup`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ status: \"needs_code\"; channel: \"email\" | \"sms\"; sentTo?: string } | { status: \"needs_phone\" } | { status: \"in_progress\"; retryAfterSeconds: number } | { status: \"signed_up\"; username: string; email: string; connection: string | null; twoFactor: \"enrolled\" | \"none\"; secrets: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"description":"TypeScript: `SignupConfirmInput`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Your Bowmark API key."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Bowmark-Key"}},"responses":{"NotFound":{"description":"No such site or function.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}},"schemas":{"RunEnvelope":{"type":"object","description":"What a run returns. `status` says whether the SCRIPT succeeded. A script that threw or paused for a login is still HTTP 200. Branch on `status`, not on the HTTP code.","required":["ok","status","result","logs","error","ms"],"properties":{"runId":{"type":"string","description":"Stable id for this run. Quote it in a support or `report` message."},"ok":{"type":"boolean","description":"False only when the run produced nothing usable."},"status":{"type":"string","enum":["ok","error","partial","needs_user"],"description":"`partial`: the result is real but some calls failed (see `incomplete`); `ok` stays true. `needs_user`: a person must sign in to a site first. Relay `meta.handoff.url` to them, then run again."},"egress":{"type":"string","enum":["default","link"],"description":"The egress the run was given, present only when the request asked for one. `link`: every request went through the caller's own Chrome (Bowmark Buddy)."},"result":{"description":"Whatever the script `return`ed. Any JSON value."},"logs":{"type":"array","items":{"type":"string"},"description":"Lines the script wrote with `log(...)`."},"error":{"type":["string","null"],"description":"Why the run failed, in plain words. Null on success."},"ms":{"type":"integer","description":"How long the script itself ran, in milliseconds."},"queuedMs":{"type":"integer","description":"How long the run waited for a worker before starting. Present only when it was a second or more."},"needs":{"type":"array","description":"The sign-ins this script is waiting on. Present when `status` is `needs_user`.","items":{"type":"object","required":["capability","provider","providerTitle","kind"],"properties":{"capability":{"type":"string"},"provider":{"type":"string"},"providerTitle":{"type":"string","description":"The site's name, to show a person."},"kind":{"type":"string"}}}},"incomplete":{"type":"object","description":"Present only when `status` is `partial`: which calls did not answer.","properties":{"summary":{"type":"string"},"totalCalls":{"type":"integer"}},"additionalProperties":true},"emptyHanded":{"type":"object","description":"Present when the script returned nothing while its calls returned rows, usually a filter that matched none of the site's own labels. Lists the label values the calls actually returned.","additionalProperties":true},"notes":{"type":"array","description":"Caveats a call attached to a complete answer. Never changes `status`.","items":{"type":"object","properties":{"path":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","properties":{"handoff":{"type":"object","description":"A single-use sign-in link for a person to open. Expires at `expiresAt`.","properties":{"ref":{"type":"string"},"url":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time"}}},"concurrency":{"type":"object","description":"On a 429: how many runs are in flight and when to retry.","properties":{"limit":{"type":"integer"},"inFlight":{"type":"integer"},"retryAfterSeconds":{"type":"integer"}}}},"additionalProperties":true},"notice":{"type":"object","description":"Set when the account owner has not accepted the current Terms. Relay it to them.","additionalProperties":true}}},"CalendlyAvailabilityOptions":{"type":"object","properties":{"timezone":{"type":"string"},"daysAhead":{"type":"number"}},"additionalProperties":true},"CalendlyBookMeetingArgs":{"type":"object","properties":{"url":{"type":"string"},"startTime":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"timezone":{"type":"string"},"guests":{"type":"array","items":{"type":"string"}},"answers":{"type":"object","additionalProperties":{"type":"string"}},"event":{"type":"string"}},"required":["url","startTime","name","email"],"additionalProperties":true},"CalendlyBookingFormOptions":{"type":"object","properties":{"event":{"type":"string"}},"additionalProperties":true},"CalendlyCancelBookingArgs":{"type":"object","properties":{"link":{"type":"string"},"reason":{"type":"string"}},"required":["link"],"additionalProperties":true},"CalendlyRescheduleBookingArgs":{"type":"object","properties":{"link":{"type":"string"},"url":{"type":"string"},"startTime":{"type":"string"},"timezone":{"type":"string"},"guests":{"type":"array","items":{"type":"string"}},"answers":{"type":"object","additionalProperties":{"type":"string"}},"event":{"type":"string"}},"required":["link","url","startTime"],"additionalProperties":true},"CalendlySubmitRoutingFormArgs":{"type":"object","properties":{"form":{"type":"string"},"answers":{"type":"object","additionalProperties":{"type":"string"}},"params":{"type":"object","additionalProperties":{"type":"string"}}},"required":["form","answers"],"additionalProperties":true}}}}