{"openapi":"3.1.0","info":{"title":"Resy API (Bowmark)","version":"e833508f87ff","description":"Restaurant search, real-time table availability and booking on Resy — venue lookup by name, open slots for a date and party size, and booking one for a diner who has a Resy account (Resy texts them a code to confirm), then cancelling it. All browserless.\n\nEvery function Bowmark has for Resy (resy.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/resy/search":{"post":{"operationId":"search","summary":"Finds Resy venues matching a restaurant name, e.g.","description":"Finds Resy venues matching a restaurant name, e.g. `bowmark.providers.resy.search(\"Paco Meralgo\")` — ranked by Resy's own relevance. Pass `{ latitude, longitude }` when you know roughly where the restaurant is: rows whose name matches then come first, nearest first, each with its `distanceKm` (so \"Carbone\" near Miami answers Carbone Miami ahead of the New York one), and when no name matches the nearest venues lead, which usually means the restaurant is not on Resy. Returns each match's numeric `venueId` (what `checkAvailability` keys on), name, its `urlSlug`/`citySlug` (together the booking-page path), locality/region/country, cuisine, price tier and rating.\n\nCalls `bowmark.providers.resy.search`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ResyVenueRow[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"anyOf":[{"type":"string"},{"type":"object","properties":{"query":{"type":"string"},"latitude":{"type":"number"},"longitude":{"type":"number"}},"required":["query"],"additionalProperties":true}],"description":"TypeScript: `string | { query: string; latitude?: number; longitude?: number }`"}},"required":["query"],"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/resy/checkAvailability":{"post":{"operationId":"checkAvailability","summary":"Reads real-time open reservation slots for one venue (`venueId` from a prior `search` row), one date (`day`, `\"YYYY-MM-DD\"` in the venue's own calendar) and a party size (default 2).","description":"Reads real-time open reservation slots for one venue (`venueId` from a prior `search` row), one date (`day`, `\"YYYY-MM-DD\"` in the venue's own calendar) and a party size (default 2). Returns each open slot's local start time, seating/section label and Resy's own booking token, alongside the venue's timezone and booking-page slugs. `slots: []` is a genuine, complete answer (\"nothing open\"), not an error.\n\nCalls `bowmark.providers.resy.checkAvailability`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ResyAvailability>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"venueId":{"type":"number"},"day":{"type":"string"},"partySize":{"type":"number"}},"required":["venueId","day"],"additionalProperties":true,"description":"TypeScript: `{ venueId: number; day: string; partySize?: number }`"}},"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/resy/startBooking":{"post":{"operationId":"startBooking","summary":"Starts booking one open Resy time for a diner who has a Resy account: checks the time is open, reads the slot's terms (refusing any slot that charges or holds a card, before anyone is texted), and has","description":"Starts booking one open Resy time for a diner who has a Resy account: checks the time is open, reads the slot's terms (refusing any slot that charges or holds a card, before anyone is texted), and has Resy TEXT A CODE to `phone`. Then call `confirmBooking({ code })` IN THE SAME BOWMARK SESSION. With the MCP tools: `session_call({ path: [\"providers\", \"resy\", \"startBooking\"], args: [{ venueId: 10281, day: \"2026-10-29\", time: \"20:00\", partySize: 2, phone: \"604-555-0123\" }] })`, ask the diner for the texted code, then `session_call({ sessionId, path: [\"providers\", \"resy\", \"confirmBooking\"], args: [{ code: \"…\" }] })` with the `sessionId` the first call returned. Over HTTP: `POST /v1/session` returns `{ sessionId }`, then `POST /v1/session/<sessionId>/call` with the same `{\"path\": [...], \"args\": [...]}`. Throws, listing the open times, when `time` is not open.\n\nCalls `bowmark.providers.resy.startBooking`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ResyBookingStarted>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ResyStartBookingArgs","description":"TypeScript: `ResyStartBookingArgs`"}},"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/resy/confirmBooking":{"post":{"operationId":"confirmBooking","summary":"Finishes the booking `startBooking` began in this session: signs the diner in with the texted code and books the slot, returning Resy's reservation id and the `resyToken` cancelBooking takes.","description":"Finishes the booking `startBooking` began in this session: signs the diner in with the texted code and books the slot, returning Resy's reservation id and the `resyToken` cancelBooking takes. Resy often asks for the email on the diner's Resy account the first time a number signs in from a new device: pass `email` up front, or call again with `{ code, email }` when the error asks. A number with no Resy account throws with the sign-up link (https://resy.com/login) to send the diner to; Bowmark does not create accounts.\n\nCalls `bowmark.providers.resy.confirmBooking`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ResyBooking>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"code":{"type":"string"},"email":{"type":"string"}},"required":["code"],"additionalProperties":true,"description":"TypeScript: `{ code: string; email?: string }`"}},"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/resy/cancelBooking":{"post":{"operationId":"cancelBooking","summary":"Cancels one of the diner's Resy reservations by its `resyToken` (from confirmBooking, or from a listBookings row).","description":"Cancels one of the diner's Resy reservations by its `resyToken` (from confirmBooking, or from a listBookings row). Needs the diner signed in in this Bowmark session: the booking's own sign-in, or startSignIn + confirmSignIn in a later session.\n\nCalls `bowmark.providers.resy.cancelBooking`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ResyCancellation>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"resyToken":{"type":"string"}},"required":["resyToken"],"additionalProperties":true,"description":"TypeScript: `{ resyToken: string }`"}},"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/resy/startSignIn":{"post":{"operationId":"startSignIn","summary":"Signs a diner back in to their own Resy account in a NEW Bowmark session, to read or cancel what they booked earlier: Resy TEXTS A CODE to `phone`.","description":"Signs a diner back in to their own Resy account in a NEW Bowmark session, to read or cancel what they booked earlier: Resy TEXTS A CODE to `phone`. Then call `confirmSignIn({ code })` in the same session. With the MCP tools: `session_call({ path: [\"providers\", \"resy\", \"startSignIn\"], args: [{ phone: \"604-555-0123\" }] })`, ask the diner for the code, then `session_call({ sessionId, path: [\"providers\", \"resy\", \"confirmSignIn\"], args: [{ code: \"…\" }] })`.\n\nCalls `bowmark.providers.resy.startSignIn`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ResySignInStarted>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"phone":{"type":"string"}},"required":["phone"],"additionalProperties":true,"description":"TypeScript: `{ phone: string }`"}},"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/resy/confirmSignIn":{"post":{"operationId":"confirmSignIn","summary":"Finishes the sign-in startSignIn began in this session with the texted code.","description":"Finishes the sign-in startSignIn began in this session with the texted code. Resy may ask for the email on the diner's account the first time a number signs in from a new device: pass `email`, or call again with `{ code, email }` when the error asks. After it, listBookings and cancelBooking act on the diner's own account for the rest of the session.\n\nCalls `bowmark.providers.resy.confirmSignIn`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ResySignedIn>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"code":{"type":"string"},"email":{"type":"string"}},"required":["code"],"additionalProperties":true,"description":"TypeScript: `{ code: string; email?: string }`"}},"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/resy/listBookings":{"post":{"operationId":"listBookings","summary":"Lists the signed-in diner's upcoming Resy reservations (venue id, day, time, party size, reservation id and the `resyToken` cancelBooking takes).","description":"Lists the signed-in diner's upcoming Resy reservations (venue id, day, time, party size, reservation id and the `resyToken` cancelBooking takes). Needs the diner signed in in this session (confirmBooking, or startSignIn + confirmSignIn). `[]` means nothing upcoming.\n\nCalls `bowmark.providers.resy.listBookings`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ResyUpcomingBooking[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"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}}},"ResyStartBookingArgs":{"type":"object","properties":{"venueId":{"type":"number"},"day":{"type":"string"},"time":{"type":"string"},"partySize":{"type":"number"},"phone":{"type":"string"},"seatingType":{"type":"string"}},"required":["venueId","day","time","partySize","phone"],"additionalProperties":true}}}}