{"openapi":"3.1.0","info":{"title":"OpenTable API (Bowmark)","version":"e833508f87ff","description":"Restaurant search, real-time table availability and booking on OpenTable: find restaurants by name, cuisine or place, read the open times for a date, time and party size, book one as a guest with the diner's name, phone and email (OpenTable texts a code to confirm), and cancel it.\n\nEvery function Bowmark has for OpenTable (opentable.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/opentable/search":{"post":{"operationId":"search","summary":"Finds restaurants on OpenTable — `bowmark.providers.opentable.search({ query: \"Kokkari Estiatorio\", latitude: 37.7749, longitude: -122.4194 })`.","description":"Finds restaurants on OpenTable — `bowmark.providers.opentable.search({ query: \"Kokkari Estiatorio\", latitude: 37.7749, longitude: -122.4194 })`. A query that names a restaurant is answered from OpenTable's own search-box suggestions: every restaurant by that name, with its `restaurantId`, neighborhood, city and coordinates (address, cuisine, price band, rating and party limit are null there; `checkAvailability` returns them). A query that names no restaurant (a cuisine, a dish) is answered from OpenTable's search page, with those fields filled. It returns no times; pass a row's `restaurantId` to `checkAvailability` for those. Pass `latitude`/`longitude` to put the restaurants nearest that point first. A real browser load, so expect 10-30 s.\n\nCalls `bowmark.providers.opentable.search`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<OpenTableSearchResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/OpenTableSearchArgs"}],"description":"TypeScript: `string | OpenTableSearchArgs`"}},"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/opentable/checkAvailability":{"post":{"operationId":"checkAvailability","summary":"Reads one restaurant's open reservation times (`restaurantId` from a `search` row) around `time` on `date` for `partySize`, with OpenTable's own booking link per time, plus the restaurant's details.","description":"Reads one restaurant's open reservation times (`restaurantId` from a `search` row) around `time` on `date` for `partySize`, with OpenTable's own booking link per time, plus the restaurant's details. Each slot carries `checkout`, a handoff URL the person opens to reserve that time themselves (Bowmark never books). `slots: []` is a real \"nothing open\". A real browser load, so expect 15-40 s.\n\nCalls `bowmark.providers.opentable.checkAvailability`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<OpenTableAvailability>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/OpenTableAvailabilityArgs","description":"TypeScript: `OpenTableAvailabilityArgs`"}},"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/opentable/startBooking":{"post":{"operationId":"startBooking","summary":"Starts a guest reservation for one open time: opens the restaurant's page at `dateTime`, clicks that time, picks a seating option when the restaurant asks for one (`seating`, else the first offered; t","description":"Starts a guest reservation for one open time: opens the restaurant's page at `dateTime`, clicks that time, picks a seating option when the restaurant asks for one (`seating`, else the first offered; the result names it and lists `seatingOptions`), accepts the restaurant's terms, presses \"Complete reservation\" and enters `diner.phone`, so OpenTable TEXTS A CODE to that phone and holds the table for 5 minutes. Then call `confirmBooking({ code })` IN THE SAME BOWMARK SESSION: the held table lives in that session's browser, so a separate `run` cannot finish it. With the MCP tools: `session_call({ path: [\"providers\", \"opentable\", \"startBooking\"], args: [{ …startBooking args }] })`, ask the person for the texted code, then `session_call({ sessionId, path: [\"providers\", \"opentable\", \"confirmBooking\"], args: [{ code: \"…\" }] })` with the `sessionId` the first call returned, within 5 minutes. Over HTTP: `POST /v1/session` (Bearer API key) returns `{ sessionId }`, and `POST /v1/session/<sessionId>/call` takes the same `{\"path\": [...], \"args\": [...]}`. Throws when `dateTime` is no longer open.\n\nCalls `bowmark.providers.opentable.startBooking`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<OpenTableBookingStarted>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/OpenTableStartBookingArgs","description":"TypeScript: `OpenTableStartBookingArgs`"}},"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/opentable/confirmBooking":{"post":{"operationId":"confirmBooking","summary":"Finishes the booking `startBooking` began in this session: enters the texted code, fills the diner's name, phone and email, presses \"Complete reservation\" and returns the confirmation number and the r","description":"Finishes the booking `startBooking` began in this session: enters the texted code, fills the diner's name, phone and email, presses \"Complete reservation\" and returns the confirmation number and the reservation's page. Throws when no booking is waiting (wrong session, or the 5-minute hold ran out) or OpenTable refuses the code.\n\nCalls `bowmark.providers.opentable.confirmBooking`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<OpenTableBooking>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"code":{"type":"string"}},"required":["code"],"additionalProperties":true,"description":"TypeScript: `{ code: 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/opentable/cancelBooking":{"post":{"operationId":"cancelBooking","summary":"Cancels a reservation from its OpenTable page (the `reservationUrl` confirmBooking returned): \"Cancel\", then \"Confirm cancellation\".","description":"Cancels a reservation from its OpenTable page (the `reservationUrl` confirmBooking returned): \"Cancel\", then \"Confirm cancellation\". Returns `canceled: true` once the page reads \"Reservation canceled\".\n\nCalls `bowmark.providers.opentable.cancelBooking`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<OpenTableCancellation>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"reservationUrl":{"type":"string"}},"required":["reservationUrl"],"additionalProperties":true,"description":"TypeScript: `{ reservationUrl: 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/opentable/getBooking":{"post":{"operationId":"getBooking","summary":"Reads a reservation back from its OpenTable page (the `reservationUrl` confirmBooking returned): `status` \"confirmed\" or \"canceled\", the restaurant and the confirmation number.","description":"Reads a reservation back from its OpenTable page (the `reservationUrl` confirmBooking returned): `status` \"confirmed\" or \"canceled\", the restaurant and the confirmation number. Works from any later session, not only the one that booked, since the page link carries the reservation's own access. Throws when the link shows no reservation.\n\nCalls `bowmark.providers.opentable.getBooking`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<OpenTableBookingStatus>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"reservationUrl":{"type":"string"}},"required":["reservationUrl"],"additionalProperties":true,"description":"TypeScript: `{ reservationUrl: 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/opentable/listMyReservations":{"post":{"operationId":"listMyReservations","summary":"Lists the signed-in diner's own OpenTable reservations, upcoming and past, newest first: restaurant, date and time, party size, OpenTable's status, a cancelled flag, and the reservation's page link wh","description":"Lists the signed-in diner's own OpenTable reservations, upcoming and past, newest first: restaurant, date and time, party size, OpenTable's status, a cancelled flag, and the reservation's page link when OpenTable gives one. Needs the caller signed in to OpenTable (through Bowmark Buddy, or a saved sign-in); empty when they have none. One page read, no browser launched.\n\nCalls `bowmark.providers.opentable.listMyReservations`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<OpenTableMyReservations>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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}}},"OpenTableAvailabilityArgs":{"type":"object","properties":{"restaurantId":{"type":"number"},"date":{"type":"string"},"time":{"type":"string"},"partySize":{"type":"number"}},"required":["restaurantId"],"additionalProperties":true},"OpenTableDiner":{"type":"object","properties":{"phone":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"}},"required":["phone","firstName","lastName","email"],"additionalProperties":true},"OpenTableSearchArgs":{"type":"object","properties":{"query":{"type":"string"},"date":{"type":"string"},"time":{"type":"string"},"partySize":{"type":"number"},"latitude":{"type":"number"},"longitude":{"type":"number"}},"required":["query"],"additionalProperties":true},"OpenTableStartBookingArgs":{"type":"object","properties":{"restaurantId":{"type":"number"},"dateTime":{"type":"string"},"partySize":{"type":"number"},"diner":{"$ref":"#/components/schemas/OpenTableDiner"},"specialRequest":{"type":"string"},"seating":{"type":"string"}},"required":["restaurantId","dateTime","partySize","diner"],"additionalProperties":true}}}}