{"openapi":"3.1.0","info":{"title":"Google Maps API (Bowmark)","version":"e833508f87ff","description":"Local business search on Google Maps — find places by what a person would say, then read the address, hours, rating, reviews, photos, co-located tenants and route. suggestPlaces (autocomplete), searchPlaces (the door), searchNearby (the same door, anchored to a point), geocodeAddress, getPlace, listReviews, listPhotos, listRelatedPlaces, getDirections, resolvePlaceUrl and reverseGeocode are built; everything else is still a declared stub.\n\nEvery function Bowmark has for Google Maps (google.com/maps) 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/google_maps/suggestPlaces":{"post":{"operationId":"suggestPlaces","summary":"Google Maps' own autocomplete for a half-typed query — what the search box offers while somebody types.","description":"Google Maps' own autocomplete for a half-typed query — what the search box offers while somebody types. Returns the completed queries, ready to hand to searchPlaces once it lands.\n\nCalls `bowmark.providers.google_maps.suggestPlaces`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<string[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SuggestPlacesArgs","description":"TypeScript: `SuggestPlacesArgs`"}},"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/google_maps/searchPlaces":{"post":{"operationId":"searchPlaces","summary":"Search for places by name or category, returning hours and open status.","description":"Search for places by name or category, returning hours and open status. Takes what a person would say — \"coffee shops in Seattle WA\", \"pizza near Austin TX\" — or a Google Maps `url` instead (a /maps/search/ link reads as its query; a place, ?ftid=, ?cid= or maps.app.goo.gl link returns that one place through the place door), and returns the ranked places Google Maps shows for it with their business hours and current open/closed status: feature id, name, a shareable url back to the place, address, coordinates and categories, plus rating, review count, weekly hours and the site's own live open/closed line (openStatus), and the business record — Places API `placeId`, `cid`, `website`, `phone`, Google's own one-line `description`, lead `image`, `reviewsUrl`, the postal address parts (`streetAddress`, `borough`, `city`, `postalCode`, `state`, `countryCode`), `timezone`, `orderOnlineUrl` and `businessStatus` (\"closed\" only when Google flags a permanent closure; absence never means open) — each present only when the site's own response carried it, all read off the record the response already carries at no extra byte. The location lives in the query text itself; Google resolves it from there, not from a separate coordinate. Every place also carries six parity fields, always present (null or [] when the record carries nothing): `claimed` (false when Google shows \"Claim this business\"), `priceRange` (the \"$$\" level — the anonymous door has not been seen to carry one, 0 of 140 places on 2026-10-29, so expect null), `orderUrls` ([{ url, platform }] — Google's own ordering link; the DoorDash/Uber Eats partner list behind it is not in this response), `tags` (service options such as \"Takeout\", \"Delivery\", positive evidence only), `about` (the About attributes as text, e.g. \"Accessibility: Wheelchair accessible entrance\"; only that section reaches an anonymous read) and `streetAddressSupplement` (the suite or unit off the street line, e.g. \"Ste 480\").\n\nCalls `bowmark.providers.google_maps.searchPlaces`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<SearchPlacesResult[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SearchPlacesArgs","description":"TypeScript: `SearchPlacesArgs`"}},"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/google_maps/searchNearby":{"post":{"operationId":"searchNearby","summary":"searchPlaces anchored to a POINT instead of resolved from the query text — for a caller holding coordinates (a pin, a phone's GPS, reverseGeocode's own output) rather than a locality name.","description":"searchPlaces anchored to a POINT instead of resolved from the query text — for a caller holding coordinates (a pin, a phone's GPS, reverseGeocode's own output) rather than a locality name. Reuses reverseGeocode's own viewport template spliced into searchPlaces' field mask: \"coffee\" anchored at a point returns results within a few hundred meters of it, measured live against two cities. Same result shape as searchPlaces, hours and openStatus included. Without this, a coordinate query has nowhere to go on searchPlaces and Google answers from whichever city the request happens to exit near.\n\nCalls `bowmark.providers.google_maps.searchNearby`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<SearchPlacesResult[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SearchNearbyArgs","description":"TypeScript: `SearchNearbyArgs`"}},"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/google_maps/geocodeAddress":{"post":{"operationId":"geocodeAddress","summary":"A street address, a city, or a business name in — the matching Google Maps place, its feature id and its coordinates out.","description":"A street address, a city, or a business name in — the matching Google Maps place, its feature id and its coordinates out. Rides the same door as searchPlaces (a second reading of the same response), so it only resolves a query that names ONE place; a category or list-style query throws. A LANDMARK whose name is also carried by the businesses around it (measured live against \"Bryant Park, New York, NY\") carries no record at the resolved-locality position Google itself uses even though searchPlaces' own ranked list puts the landmark first — for exactly that shape, this falls back to that list's first entry when its name matches the query's own leading name segment and its address sits in the locality the query names, and says so in `warnings` rather than returning it silently.\n\nCalls `bowmark.providers.google_maps.geocodeAddress`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GeocodeAddressResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GeocodeAddressArgs","description":"TypeScript: `GeocodeAddressArgs`"}},"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/google_maps/reverseGeocode":{"post":{"operationId":"reverseGeocode","summary":"A point in — the Plus Code and locality Google Maps shows for it out, the same string a person sees when they drop a pin (\"JMC2+57W Seattle, Washington\"), never a street address: that is what the site","description":"A point in — the Plus Code and locality Google Maps shows for it out, the same string a person sees when they drop a pin (\"JMC2+57W Seattle, Washington\"), never a street address: that is what the site itself answers for a bare point, verified live against the White House's own coordinates. Rides the same tbm=map door searchPlaces and geocodeAddress use, with a different field mask — not the browser rung the survey queued this for; the browser pass that found the field mask was how the shape was discovered, not what the shipped function needs.\n\nCalls `bowmark.providers.google_maps.reverseGeocode`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ReverseGeocodeResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ReverseGeocodeArgs","description":"TypeScript: `ReverseGeocodeArgs`"}},"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/google_maps/getPlace":{"post":{"operationId":"getPlace","summary":"Get detailed business information including hours of operation, current open/closed status and availability.","description":"Get detailed business information including hours of operation, current open/closed status and availability. Returns everything Google Maps shows on one business's panel — name, full address, coordinates, category, neighborhood, phone, website, rating, review count, weekly hours, the site's own live open/closed line (e.g. \"Closed · Opens 7 AM\"), its accessibility labels (e.g. \"Wheelchair accessible entrance\") and businessStatus, present and always \"closed\" ONLY when the site has flagged the listing permanently closed — each present only when the site's own response carried it. openStatus is the site's rendered string, not a boolean this provider computed — hours' display strings carry no timezone, so a caller cannot derive open-right-now from them without it. accessibility is absent when the site publishes nothing for that place, never a guess — the field mask carries no other amenity category (Wi-Fi, outdoor seating, …) at all — service options come from separate signals, see serviceOptions. businessStatus reports a CONFIRMED closure honestly (measured live against Mamnoon, Plum Bistro, Harbor City Restaurant and Copine, all recently closed) but its absence never means the business is open — Google does not flag every real-world closure, confirmed live against two long-defunct Toys \"R\" Us locations that carry no marker at all. This retries a few times to see past a reduced/rich flap in the site's own response and merges the richest draw; `warnings` is non-empty when every attempt drew the reduced record, meaning reviewCount/hours/openStatus could not be confirmed either way rather than being genuinely absent. `serviceOptions` (the result field) lists how the place serves food — \"Dine-in\", \"Takeout\", \"Delivery\", \"Drive-through\" — read browserless from three signals in the same record: a per-service hours block Google publishes (\"Delivery 6 AM–9:30 PM\"), the order types the place's \"Order online\" action takes, and reviewers' own answers to \"Did you dine in, take out, or get delivery?\"; measured 2026-10-03 on McDonald's, Chipotle, Canlis, Thai Tom and Dick's Drive-In. It is POSITIVE evidence only: an option missing from it is unknown, never \"does not offer\", and the field is absent when no signal exists (Pagliacci Pizza). `orderOnlineUrl` is the site's own Google ordering link when the place takes orders through Google. `website` is ONE url, the business's own homepage link from the panel. It is not a list of every link Google shows: a separate Reserve or Book button (a booking platform such as Planity, Treatwell or OpenTable) is not read into any field, so a missing booking link here never means the business takes no online bookings. To check that, read its website with `bowmark.read.page` (the default markdown format keeps every link's url). `serviceOptions: true` (the argument) additionally opts into a SEPARATE ~15s browser read of the About tab — an anonymous read of that tab serves Google's own \"limited view\" banner and no Service options section (measured 2026-09-30 against Pagliacci Pizza, Thai Tom and Dick's Drive-In), so it only adds anything with the caller's own Google session granted, and pushes a `warnings` entry rather than staying silent when the panel came back limited. A THIRD reading of searchPlaces' door: takes the same resolving query geocodeAddress does (typically a name plus address, since this does not take a feature id — measured live, neither the raw id nor a cid string resolves through this door), and throws when the query names a category or list rather than one business.\n\nCalls `bowmark.providers.google_maps.getPlace`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GetPlaceResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetPlaceArgs","description":"TypeScript: `GetPlaceArgs`"}},"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/google_maps/listReviews":{"post":{"operationId":"listReviews","summary":"The reviews Google Maps shows for a business, each with author, star rating, review text, the site's own relative date AND an ISO posting time, the review's id, link and language, the reviewer's profi","description":"The reviews Google Maps shows for a business, each with author, star rating, review text, the site's own relative date AND an ISO posting time, the review's id, link and language, the reviewer's profile link, photo, review and photo counts and Local Guide badge, any photos attached (url + Google's caption), and the reviewer's structured answers (per-aspect stars like \"Food\": 5, choices like \"Noise level\": \"Moderate noise\") as `details`. Returns `{ reviews, reviewCount, featureId, ratingHistogram, warnings }`: `reviewCount` is the site's own TOTAL and `ratingHistogram` its per-star counts, so `reviews.length` is never mistaken for the whole picture. Takes exactly one of `query` (a resolving query naming one business, as getPlace takes), `featureId` (what searchPlaces/getPlace/resolvePlaceUrl return; skips the resolve hop) or `url` (a Maps place, ?ftid=, ?cid=, maps.app.goo.gl or /maps/search/ link; a search link uses its first result). With no sort, paged or limit past it, the answer is the place panel's own ~5 most-relevant reviews in one request. Anything more pages the FULL review list, logged out, with no sign-in: `limit` (1-1000) is how many to read, `paged: true` alone reads 100, and `sort` (\"relevant\" default | \"newest\" | \"highest\" | \"lowest\" — Google offers no \"oldest\", refused by name) is the order. It reads Google Search's own review feed, ~50 reviews a page (measured 2026-10-28: 1,000 unique reviews of Analog Coffee in 20 pages, ~17 s), and each review from it also carries the business's own reply as `ownerReply` when it posted one; a rating-only review comes back with text \"\". A feed page lost mid-walk is named in `warnings` and the reviews read before it are returned.\n\nCalls `bowmark.providers.google_maps.listReviews`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ListReviewsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ListReviewsArgs","description":"TypeScript: `ListReviewsArgs`"}},"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/google_maps/listRelatedPlaces":{"post":{"operationId":"listRelatedPlaces","summary":"Other businesses Google Maps lists \"At this place\" — the site's own label for a shared address, not the \"people also search for\" competitor set the survey planned.","description":"Other businesses Google Maps lists \"At this place\" — the site's own label for a shared address, not the \"people also search for\" competitor set the survey planned. A FIFTH reading of searchPlaces' door (the same record getPlace reads, at [204]). Verified 2026-09-15: `null` for an ordinary standalone business (confirmed against four, including Analog Coffee and Pike Place Market), populated only for a multi-tenant venue — Space Needle's own gift shop, café and lounge; a 61-store list for Westlake Center mall. Returns [] for a single-business query rather than throwing; throws only when the query itself does not resolve to one place.\n\nCalls `bowmark.providers.google_maps.listRelatedPlaces`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RelatedPlace[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ListRelatedPlacesArgs","description":"TypeScript: `ListRelatedPlacesArgs`"}},"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/google_maps/getDirections":{"post":{"operationId":"getDirections","summary":"A DIFFERENT door from searchPlaces' — www.google.com/maps/preview/directions, its own reusable pb= template (BUILD_QUEUE.md), one per mode.","description":"A DIFFERENT door from searchPlaces' — www.google.com/maps/preview/directions, its own reusable pb= template (BUILD_QUEUE.md), one per mode. Takes origin and destination as text, exactly what a person would type (\"Space Needle, Seattle, WA\") or a searchPlaces/geocodeAddress result's name plus address — not a feature id, measured live the same way getPlace measured it. mode defaults to \"driving\"; \"walking\" and \"transit\" are also built. \"bicycling\" is not: its response shape diverges enough that a route total cannot be read off it safely yet. waypoints is one or more stops in order (\"a pharmacy on the way\") — the site's own door takes only two endpoints, so each stop is stitched as its own leg through the identical door and the real per-leg totals summed; distance and duration are then OUR text rather than the site's own (still real numbers, never invented). Returns the site's own trip total (distance, duration, traffic-aware for driving) plus the turn-by-turn instructions, each carrying the site's own distance and duration text. Transit mode steps are not only walking instructions: each bus or train ride is its own step carrying transit: { line (the line name, e.g. \"1 California\" is line \"1\", \"594\"), vehicle (\"Bus\", \"Cable car\", \"Light rail\"), headsign, boardStop, alightStop (the stop to board and the stop to alight at), departureTime, arrivalTime, numStops }, between the walking steps, and the result carries numTransfers — the transfer count, i.e. the number of transfers — exactly what Google's own transit panel shows. Throws when any leg does not resolve to a route. Always the current right-now trip — arriveBy and departAt are refused by name rather than silently accepted and ignored (qa/20); nobody has measured this door's clock-time anchor yet.\n\nCalls `bowmark.providers.google_maps.getDirections`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GetDirectionsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetDirectionsArgs","description":"TypeScript: `GetDirectionsArgs`"}},"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/google_maps/resolvePlaceUrl":{"post":{"operationId":"resolvePlaceUrl","summary":"A Google Maps link somebody pasted — a maps.app.goo.gl short link, a full /maps/place/ link, or the older ?ftid=/?cid= link — turned into the feature id and name it points at.","description":"A Google Maps link somebody pasted — a maps.app.goo.gl short link, a full /maps/place/ link, or the older ?ftid=/?cid= link — turned into the feature id and name it points at. Two of the three shapes need no network call at all: everything returned is already sitting in the URL string, since fetching a resolved link live only echoes the request back rather than adding data (measured 2026-09-15). Only a short link costs a request — one redirect-follow, reading the destination out of the \"location\" header rather than the (contentless) body. A bare ?cid= link resolves only the LOW half of the feature id and carries no name, reported as \"0x0:0x<lo>\" the same way the site's own echo does. Throws when the link resolves to something that is not a place — a dropped-pin share or a review share, both measured live.\n\nCalls `bowmark.providers.google_maps.resolvePlaceUrl`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GoogleMapsPlace>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ResolvePlaceUrlArgs","description":"TypeScript: `ResolvePlaceUrlArgs`"}},"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/google_maps/listPhotos":{"post":{"operationId":"listPhotos","summary":"The photos Google Maps shows in a place's gallery panel — up to 20, each with a url, its real dimensions and the site's own upload-source tag (\"photos:gmm_ios_review_post\" and similar — which app and ","description":"The photos Google Maps shows in a place's gallery panel — up to 20, each with a url, its real dimensions and the site's own upload-source tag (\"photos:gmm_ios_review_post\" and similar — which app and flow it came in through, not a caption; none was found at any position tried), plus a date when the response carried one. A THIRD door, not searchPlaces' field mask: opening the place page's own photo panel fires its own batchexecute RPC, which is not a bootstrap-derived static template the way searchPlaces' and reverseGeocode's are — a browser genuinely has to run to get the real gallery back, measured 2026-09-16. Takes a featureId (searchPlaces/geocodeAddress/getPlace/resolvePlaceUrl all hand one back), not a resolving query.\n\nCalls `bowmark.providers.google_maps.listPhotos`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<Photo[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ListPhotosArgs","description":"TypeScript: `ListPhotosArgs`"}},"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/google_maps/getPopularTimes":{"post":{"operationId":"getPopularTimes","summary":"The \"popular times\" histogram for a place, from the CALLER's own signed-in Google session — an authFunction, not a park: Bowmark signs nobody up for a Google account, but the caller's own login works ","description":"The \"popular times\" histogram for a place, from the CALLER's own signed-in Google session — an authFunction, not a park: Bowmark signs nobody up for a Google account, but the caller's own login works here exactly as it does on youtube's signed-in functions. Reads the same resolved-place record getPlace/listReviews already parse, with the caller's cookies attached, and reports a real histogram when Google's field mask carries one for this session. With no session (the canary's own state), or when the response carries no recognizable histogram, throws rather than fabricating one — nobody here holds a signed-in Maps session to have ever captured the positive shape.\n\nCalls `bowmark.providers.google_maps.getPopularTimes`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<PopularTimesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetPopularTimesArgs","description":"TypeScript: `GetPopularTimesArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/google_maps/listSavedPlaces":{"post":{"operationId":"listSavedPlaces","summary":"The places the signed-in caller saved — Favourites, Want to go, Starred and their own named lists — an authFunction: Bowmark signs nobody up for a Google account, but the caller's own login works here","description":"The places the signed-in caller saved — Favourites, Want to go, Starred and their own named lists — an authFunction: Bowmark signs nobody up for a Google account, but the caller's own login works here exactly as it does on getPopularTimes. A DIFFERENT door from the rest of this provider — www.google.com/maps/preview/entitylist/getlist, found by reading a logged-out www.google.com/maps/@ page's own prefetch links, not a further reading of searchPlaces' tbm=map record. Needs no bootstrap fetch: the pb= value it takes is a static, reusable template exactly like _client's own (measured live — a real per-page-load token, a fabricated one and no token at all all answer identically). With no session (the canary's own state, and every anonymous caller) it returns the site's own well-formed refusal, distinct from a malformed request; with a session that carries no recognizable list, or when the response carries no recognizable list at all, throws rather than fabricating one — nobody here holds a signed-in Maps session to have ever captured the positive shape.\n\nCalls `bowmark.providers.google_maps.listSavedPlaces`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ListSavedPlacesResult>`.","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"}}}}}}},"/v1/sites/google_maps/listMyContributions":{"post":{"operationId":"listMyContributions","summary":"The reviews, photos, answers and edits the signed-in caller has contributed, with their view counts — the Local Guides profile, read back.","description":"The reviews, photos, answers and edits the signed-in caller has contributed, with their view counts — the Local Guides profile, read back. An authFunction, same shape as getPopularTimes/listSavedPlaces: Bowmark signs nobody up for a Google account, but the caller's own login works here. Found by intercepting a real browser's own network call while it loaded a PUBLIC Local Guide profile (www.google.com/maps/contrib/<id>) logged out — a THIRD door, www.google.com/locationhistory/preview/mas, distinct from both searchPlaces' tbm=map record and listSavedPlaces' entitylist door. Needs no bootstrap fetch: verified live against three real contributors that a fabricated per-page token answers byte-identically to a real one. Sends the literal contributor id \"me\", exactly what a signed-in browser sends on /maps/contrib/me — measured live to draw the identical well-formed refusal a nonexistent numeric id draws when nobody is signed in. With no session (the canary's own state, and every anonymous caller) it returns that refusal; with a session that carries no recognizable profile, throws rather than fabricating one — nobody here holds a signed-in Maps session to have captured the signed-in-and-empty case.\n\nCalls `bowmark.providers.google_maps.listMyContributions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<MyContributionsResult>`.","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"}}}}}}},"/v1/sites/google_maps/savePlace":{"post":{"operationId":"savePlace","summary":"Saves a place to one of the signed-in caller's own lists — the Maps equivalent of a bookmark.","description":"Saves a place to one of the signed-in caller's own lists — the Maps equivalent of a bookmark. An authFunction, same shape as getPopularTimes/listSavedPlaces/listMyContributions: Bowmark signs nobody up for a Google account, but the caller's own login works here. Unlike this provider's other authFunctions, saving is a WRITE only a real browser can perform — it drives the place page's own Save control and confirms the site's createitem call went through, rather than reading a field mask. Takes a featureId, exactly what searchPlaces/geocodeAddress/getPlace/resolvePlaceUrl all hand back. With no session it throws rather than attempting the click; nobody here holds a signed-in Maps session to have captured the positive shape.\n\nCalls `bowmark.providers.google_maps.savePlace`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<SavePlaceResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SavePlaceArgs","description":"TypeScript: `SavePlaceArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/google_maps/writeReview":{"post":{"operationId":"writeReview","summary":"Posts a 1-5 star rating and optional text on a place as the signed-in caller, through Google's own review composer (search.google.com/local/writereview?placeid=).","description":"Posts a 1-5 star rating and optional text on a place as the signed-in caller, through Google's own review composer (search.google.com/local/writereview?placeid=). An authFunction: the caller's own Google login, never ours; the fleet never fires it. Takes the Places API placeId searchPlaces returns. Logged out the door 302s to accounts.google.com (measured 2026-11-07), so with no session it throws rather than attempting the click.\n\nCalls `bowmark.providers.google_maps.writeReview`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WriteReviewResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/WriteReviewArgs","description":"TypeScript: `WriteReviewArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/google_maps/suggestPlaceEdit":{"post":{"operationId":"suggestPlaceEdit","summary":"Sends Google a correction about a place (wrong details, closed or moved, other) through the place panel's Suggest an edit control, as the signed-in caller.","description":"Sends Google a correction about a place (wrong details, closed or moved, other) through the place panel's Suggest an edit control, as the signed-in caller. An authFunction: the caller's own login. Takes a featureId; with no session it throws rather than attempting the click.\n\nCalls `bowmark.providers.google_maps.suggestPlaceEdit`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<SuggestPlaceEditResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SuggestPlaceEditArgs","description":"TypeScript: `SuggestPlaceEditArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/google_maps/addMissingPlace":{"post":{"operationId":"addMissingPlace","summary":"Adds a business Google Maps does not list yet (name, address, optional category, phone, website) through the Maps menu's Add a missing place form, as the signed-in caller.","description":"Adds a business Google Maps does not list yet (name, address, optional category, phone, website) through the Maps menu's Add a missing place form, as the signed-in caller. An authFunction: the caller's own login. With no session it throws rather than attempting the form.\n\nCalls `bowmark.providers.google_maps.addMissingPlace`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AddMissingPlaceResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/AddMissingPlaceArgs","description":"TypeScript: `AddMissingPlaceArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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}}},"AddMissingPlaceArgs":{"type":"object","properties":{"name":{"type":"string"},"address":{"type":"string"},"category":{"type":"string"},"phone":{"type":"string"},"website":{"type":"string"}},"required":["name","address"],"additionalProperties":true},"GeocodeAddressArgs":{"type":"object","properties":{"address":{"type":"string"}},"required":["address"],"additionalProperties":true},"GetDirectionsArgs":{"type":"object","properties":{"origin":{"type":"string"},"destination":{"type":"string"},"mode":{"anyOf":[{"const":"driving"},{"const":"walking"},{"const":"transit"}]},"waypoints":{"type":"array","items":{"type":"string"}}},"required":["origin","destination"],"additionalProperties":true},"GetPlaceArgs":{"type":"object","properties":{"query":{"type":"string"},"serviceOptions":{"type":"boolean"}},"required":["query"],"additionalProperties":true},"GetPopularTimesArgs":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"],"additionalProperties":true},"ListPhotosArgs":{"type":"object","properties":{"featureId":{"type":"string"}},"required":["featureId"],"additionalProperties":true},"ListRelatedPlacesArgs":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"],"additionalProperties":true},"ListReviewsArgs":{"type":"object","properties":{"query":{"type":"string"},"featureId":{"type":"string"},"url":{"type":"string"},"sort":{"anyOf":[{"const":"relevant"},{"const":"newest"},{"const":"highest"},{"const":"lowest"}]},"limit":{"type":"number"},"paged":{"type":"boolean"}},"additionalProperties":true},"ResolvePlaceUrlArgs":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":true},"ReverseGeocodeArgs":{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"}},"required":["lat","lng"],"additionalProperties":true},"SavePlaceArgs":{"type":"object","properties":{"featureId":{"type":"string"}},"required":["featureId"],"additionalProperties":true},"SearchNearbyArgs":{"type":"object","properties":{"query":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["query","lat","lng"],"additionalProperties":true},"SearchPlacesArgs":{"type":"object","properties":{"query":{"type":"string"},"url":{"type":"string"}},"additionalProperties":true},"SuggestPlaceEditArgs":{"type":"object","properties":{"featureId":{"type":"string"},"kind":{"anyOf":[{"const":"wrong_info"},{"const":"closed"},{"const":"other"}]},"details":{"type":"string"}},"required":["featureId","kind","details"],"additionalProperties":true},"SuggestPlacesArgs":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"],"additionalProperties":true},"WriteReviewArgs":{"type":"object","properties":{"placeId":{"type":"string"},"rating":{"type":"number"},"text":{"type":"string"}},"required":["placeId","rating"],"additionalProperties":true}}}}