{"openapi":"3.1.0","info":{"title":"National Weather Service API (Bowmark)","version":"e833508f87ff","description":"National Weather Service forecasts, alerts, current conditions, radar and forecast-office products for any US place, keyless and public.\n\nEvery function Bowmark has for National Weather Service (api.weather.gov) 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/nws/searchLocation":{"post":{"operationId":"searchLocation","summary":"Turns what a person types into weather.gov's own search box into candidate places with name, state, latitude and longitude — the door every other NWS function needs, since the API only speaks coordina","description":"Turns what a person types into weather.gov's own search box into candidate places with name, state, latitude and longitude — the door every other NWS function needs, since the API only speaks coordinates.\n\nCalls `bowmark.providers.nws.searchLocation`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<SearchLocationResult[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SearchLocationArgs","description":"TypeScript: `SearchLocationArgs`"}},"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/nws/getPoint":{"post":{"operationId":"getPoint","summary":"Everything NWS knows about one place: its forecast grid cell, forecast/county/fire zones, nearest radar station and time zone.","description":"Everything NWS knows about one place: its forecast grid cell, forecast/county/fire zones, nearest radar station and time zone. The hop that turns a place into the ids the forecast, zone, station and office functions take.\n\nCalls `bowmark.providers.nws.getPoint`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsPoint>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetPointArgs","description":"TypeScript: `GetPointArgs`"}},"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/nws/getForecast":{"post":{"operationId":"getForecast","summary":"The 7-day forecast a person reads on weather.gov — fourteen day/night periods with temperature, wind, chance of precipitation, a short phrase and the full detailed sentence.","description":"The 7-day forecast a person reads on weather.gov — fourteen day/night periods with temperature, wind, chance of precipitation, a short phrase and the full detailed sentence.\n\nCalls `bowmark.providers.nws.getForecast`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ForecastPeriod[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetForecastArgs","description":"TypeScript: `GetForecastArgs`"}},"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/nws/getHourlyForecast":{"post":{"operationId":"getHourlyForecast","summary":"The hour-by-hour forecast for the next week — temperature, dewpoint, humidity, wind and chance of precipitation per hour.","description":"The hour-by-hour forecast for the next week — temperature, dewpoint, humidity, wind and chance of precipitation per hour. What answers \"will it be raining at 3pm\".\n\nCalls `bowmark.providers.nws.getHourlyForecast`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<ForecastPeriod[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetHourlyForecastArgs","description":"TypeScript: `GetHourlyForecastArgs`"}},"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/nws/getActiveAlerts":{"post":{"operationId":"getActiveAlerts","summary":"The weather warnings, watches and advisories in effect right now — for a place, a state, or a zone, optionally narrowed to one event type or severity.","description":"The weather warnings, watches and advisories in effect right now — for a place, a state, or a zone, optionally narrowed to one event type or severity.\n\nCalls `bowmark.providers.nws.getActiveAlerts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsAlert[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetActiveAlertsArgs","description":"TypeScript: `GetActiveAlertsArgs`"}},"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/nws/getCurrentConditions":{"post":{"operationId":"getCurrentConditions","summary":"The weather right now at the nearest observing station — temperature, dewpoint, humidity, wind and gusts, pressure, visibility, sky, wind chill or heat index, and the raw METAR.","description":"The weather right now at the nearest observing station — temperature, dewpoint, humidity, wind and gusts, pressure, visibility, sky, wind chill or heat index, and the raw METAR. Takes a place name, \"lat,lon\" or a station id like KBOS.\n\nCalls `bowmark.providers.nws.getCurrentConditions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsObservation>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetCurrentConditionsArgs","description":"TypeScript: `GetCurrentConditionsArgs`"}},"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/nws/getForecastDiscussion":{"post":{"operationId":"getForecastDiscussion","summary":"The latest Area Forecast Discussion — the forecasters' own write-up of what they expect and how confident they are.","description":"The latest Area Forecast Discussion — the forecasters' own write-up of what they expect and how confident they are. Takes a forecast office id like BOX, or a place name that resolves to its office.\n\nCalls `bowmark.providers.nws.getForecastDiscussion`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsTextProduct>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetForecastDiscussionArgs","description":"TypeScript: `GetForecastDiscussionArgs`"}},"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/nws/getAlert":{"post":{"operationId":"getAlert","summary":"One weather alert in full by its id — the complete text and instructions, the sender office, every affected zone id and the earlier alerts it updates or cancels.","description":"One weather alert in full by its id — the complete text and instructions, the sender office, every affected zone id and the earlier alerts it updates or cancels. Ids come from getActiveAlerts.\n\nCalls `bowmark.providers.nws.getAlert`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsAlertDetail>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetAlertArgs","description":"TypeScript: `GetAlertArgs`"}},"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/nws/findStations":{"post":{"operationId":"findStations","summary":"Find NWS observation stations nearest a place (nearest first) or across a state, with station id, name, coordinates, elevation and zone.","description":"Find NWS observation stations nearest a place (nearest first) or across a state, with station id, name, coordinates, elevation and zone. The finder for the station-taking functions.\n\nCalls `bowmark.providers.nws.findStations`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsStation[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/FindStationsArgs","description":"TypeScript: `FindStationsArgs`"}},"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/nws/getObservationHistory":{"post":{"operationId":"getObservationHistory","summary":"Past observations at a station over a time window, newest first — what the temperature, wind, pressure and sky actually were yesterday or over the last week.","description":"Past observations at a station over a time window, newest first — what the temperature, wind, pressure and sky actually were yesterday or over the last week. Takes a station id like KBOS or a place name.\n\nCalls `bowmark.providers.nws.getObservationHistory`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsObservation[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetObservationHistoryArgs","description":"TypeScript: `GetObservationHistoryArgs`"}},"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/nws/getGridpointData":{"post":{"operationId":"getGridpointData","summary":"The raw numbers behind a forecast for one grid cell — snowfall and rainfall amounts, gusts, sky cover, heat index, wave height and the other numeric layers as time series.","description":"The raw numbers behind a forecast for one grid cell — snowfall and rainfall amounts, gusts, sky cover, heat index, wave height and the other numeric layers as time series. For \"how many inches of snow\", not a sentence.\n\nCalls `bowmark.providers.nws.getGridpointData`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsGridpointData>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetGridpointDataArgs","description":"TypeScript: `GetGridpointDataArgs`"}},"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/nws/findZones":{"post":{"operationId":"findZones","summary":"Find NWS forecast, county, fire or marine zones in a state or containing a place, with zone id, name and forecast office.","description":"Find NWS forecast, county, fire or marine zones in a state or containing a place, with zone id, name and forecast office. The finder for the zone-taking functions.\n\nCalls `bowmark.providers.nws.findZones`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsZone[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/FindZonesArgs","description":"TypeScript: `FindZonesArgs`"}},"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/nws/getZoneForecast":{"post":{"operationId":"getZoneForecast","summary":"The text forecast NWS writes for a whole forecast or fire-weather zone — one paragraph per period, as read on NOAA Weather Radio.","description":"The text forecast NWS writes for a whole forecast or fire-weather zone — one paragraph per period, as read on NOAA Weather Radio. Takes a zone id like MAZ015 or a place name.\n\nCalls `bowmark.providers.nws.getZoneForecast`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsZoneForecast>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetZoneForecastArgs","description":"TypeScript: `GetZoneForecastArgs`"}},"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/nws/listAlertTypes":{"post":{"operationId":"listAlertTypes","summary":"Every alert event name NWS issues (\"Winter Storm Warning\", \"Air Quality Alert\" …) — the exact strings getActiveAlerts' event filter takes.","description":"Every alert event name NWS issues (\"Winter Storm Warning\", \"Air Quality Alert\" …) — the exact strings getActiveAlerts' event filter takes.\n\nCalls `bowmark.providers.nws.listAlertTypes`. 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/ListAlertTypesArgs","description":"TypeScript: `ListAlertTypesArgs`"}},"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/nws/searchAlerts":{"post":{"operationId":"searchAlerts","summary":"Alerts issued in a past window, expired ones included — \"every tornado warning in Oklahoma since Monday\" — by place, state or zone, event, severity and start/end, newest first, paged by cursor.","description":"Alerts issued in a past window, expired ones included — \"every tornado warning in Oklahoma since Monday\" — by place, state or zone, event, severity and start/end, newest first, paged by cursor.\n\nCalls `bowmark.providers.nws.searchAlerts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsAlertPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/SearchAlertsArgs","description":"TypeScript: `SearchAlertsArgs`"}},"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/nws/getAlertCounts":{"post":{"operationId":"getAlertCounts","summary":"How many alerts are active right now — the national total, land vs marine, and per marine region, state and zone.","description":"How many alerts are active right now — the national total, land vs marine, and per marine region, state and zone. The \"how bad is it out there\" overview.\n\nCalls `bowmark.providers.nws.getAlertCounts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsAlertCounts>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetAlertCountsArgs","description":"TypeScript: `GetAlertCountsArgs`"}},"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/nws/getOffice":{"post":{"operationId":"getOffice","summary":"One NWS forecast office — name, street address, phone, email, website, and the county, forecast and fire zones and observation stations it covers.","description":"One NWS forecast office — name, street address, phone, email, website, and the county, forecast and fire zones and observation stations it covers. Takes an office id like BOX or a place name.\n\nCalls `bowmark.providers.nws.getOffice`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsOffice>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetOfficeArgs","description":"TypeScript: `GetOfficeArgs`"}},"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/nws/getMarineForecast":{"post":{"operationId":"getMarineForecast","summary":"The coastal-waters forecast for one marine zone — zone name, issue time, any advisory headline, and winds/waves by period.","description":"The coastal-waters forecast for one marine zone — zone name, issue time, any advisory headline, and winds/waves by period. Takes a marine zone id like ANZ230 (Boston Harbor).\n\nCalls `bowmark.providers.nws.getMarineForecast`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsMarineForecast>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetMarineForecastArgs","description":"TypeScript: `GetMarineForecastArgs`"}},"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/nws/getTextProduct":{"post":{"operationId":"getTextProduct","summary":"The latest issuance of any NWS text product at an office ({ type: \"HWO\", office: \"BOX\" }), or one issuance by { id }.","description":"The latest issuance of any NWS text product at an office ({ type: \"HWO\", office: \"BOX\" }), or one issuance by { id }.\n\nCalls `bowmark.providers.nws.getTextProduct`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsTextProduct>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetTextProductArgs","description":"TypeScript: `GetTextProductArgs`"}},"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/nws/getWeatherStories":{"post":{"operationId":"getWeatherStories","summary":"A forecast office's current weather-story briefing graphics — title, plain-language description, alt text, valid window and the image URL.","description":"A forecast office's current weather-story briefing graphics — title, plain-language description, alt text, valid window and the image URL. Takes an office id like BOX or a place name.\n\nCalls `bowmark.providers.nws.getWeatherStories`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsWeatherStory[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetWeatherStoriesArgs","description":"TypeScript: `GetWeatherStoriesArgs`"}},"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/nws/getOfficeHeadlines":{"post":{"operationId":"getOfficeHeadlines","summary":"The headlines a forecast office has posted — event notices, outreach and announcements — with title, link, important flag and issue time, newest first.","description":"The headlines a forecast office has posted — event notices, outreach and announcements — with title, link, important flag and issue time, newest first. Empty when the office has posted none. Takes an office id like OKX or a place name.\n\nCalls `bowmark.providers.nws.getOfficeHeadlines`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsOfficeHeadline[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetOfficeHeadlinesArgs","description":"TypeScript: `GetOfficeHeadlinesArgs`"}},"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/nws/listTextProducts":{"post":{"operationId":"listTextProducts","summary":"Which text products an office issues ({ office: \"BOX\" }), or the recent issuances of one type with ids and issue times ({ office: \"BOX\", type: \"AFD\" }) — the finder for getTextProduct.","description":"Which text products an office issues ({ office: \"BOX\" }), or the recent issuances of one type with ids and issue times ({ office: \"BOX\", type: \"AFD\" }) — the finder for getTextProduct.\n\nCalls `bowmark.providers.nws.listTextProducts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsTextProductListing>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ListTextProductsArgs","description":"TypeScript: `ListTextProductsArgs`"}},"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/nws/listSigmets":{"post":{"operationId":"listSigmets","summary":"The SIGMETs valid right now — aviation hazard warnings for convection, turbulence, icing and volcanic ash — with issuing office, region, hazard code, valid window and the area as lat/lon points, newes","description":"The SIGMETs valid right now — aviation hazard warnings for convection, turbulence, icing and volcanic ash — with issuing office, region, hazard code, valid window and the area as lat/lon points, newest first. Optionally one issuing office (atsu).\n\nCalls `bowmark.providers.nws.listSigmets`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsSigmet[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/ListSigmetsArgs","description":"TypeScript: `ListSigmetsArgs`"}},"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/nws/getWeatherRadio":{"post":{"operationId":"getWeatherRadio","summary":"NOAA Weather Radio: what is being broadcast for a place right now, as plain-text paragraphs ({ place }), and/or one transmitter's frequency, site, SAME codes and counties ({ callSign: \"KHB35\" }).","description":"NOAA Weather Radio: what is being broadcast for a place right now, as plain-text paragraphs ({ place }), and/or one transmitter's frequency, site, SAME codes and counties ({ callSign: \"KHB35\" }).\n\nCalls `bowmark.providers.nws.getWeatherRadio`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsWeatherRadio>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GetWeatherRadioArgs","description":"TypeScript: `GetWeatherRadioArgs`"}},"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/nws/lookupGlossary":{"post":{"operationId":"lookupGlossary","summary":"What an NWS term means, from NWS's own glossary — exact term first, then terms that start with or contain it.","description":"What an NWS term means, from NWS's own glossary — exact term first, then terms that start with or contain it. \"red flag warning\", \"dew point\", \"QPF\".\n\nCalls `bowmark.providers.nws.lookupGlossary`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsGlossaryEntry[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/LookupGlossaryArgs","description":"TypeScript: `LookupGlossaryArgs`"}},"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/nws/findRadarStations":{"post":{"operationId":"findRadarStations","summary":"NWS radar sites (WSR-88D and TDWR) with id, name, location and whether each is up right now — nearest-first for a place, or one by id like KBOX.","description":"NWS radar sites (WSR-88D and TDWR) with id, name, location and whether each is up right now — nearest-first for a place, or one by id like KBOX.\n\nCalls `bowmark.providers.nws.findRadarStations`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NwsRadarStation[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/FindRadarStationsArgs","description":"TypeScript: `FindRadarStationsArgs`"}},"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}}},"FindRadarStationsArgs":{"type":"object","properties":{"place":{"type":"string"},"id":{"type":"string"},"stationType":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true},"FindStationsArgs":{"type":"object","properties":{"place":{"type":"string"},"state":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true},"FindZonesArgs":{"type":"object","properties":{"place":{"type":"string"},"area":{"type":"string"},"type":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true},"GetActiveAlertsArgs":{"type":"object","properties":{"place":{"type":"string"},"area":{"type":"string"},"zone":{"type":"string"},"event":{"type":"string"},"severity":{"type":"string"}},"additionalProperties":true},"GetAlertArgs":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":true},"GetAlertCountsArgs":{"type":"object","properties":{},"additionalProperties":true},"GetCurrentConditionsArgs":{"type":"object","properties":{"place":{"type":"string"}},"required":["place"],"additionalProperties":true},"GetForecastArgs":{"type":"object","properties":{"place":{"type":"string"}},"required":["place"],"additionalProperties":true},"GetForecastDiscussionArgs":{"type":"object","properties":{"place":{"type":"string"}},"required":["place"],"additionalProperties":true},"GetGridpointDataArgs":{"type":"object","properties":{"place":{"type":"string"},"layers":{"type":"array","items":{"type":"string"}}},"required":["place"],"additionalProperties":true},"GetHourlyForecastArgs":{"type":"object","properties":{"place":{"type":"string"}},"required":["place"],"additionalProperties":true},"GetMarineForecastArgs":{"type":"object","properties":{"zone":{"type":"string"}},"required":["zone"],"additionalProperties":true},"GetObservationHistoryArgs":{"type":"object","properties":{"place":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"limit":{"type":"number"}},"required":["place"],"additionalProperties":true},"GetOfficeArgs":{"type":"object","properties":{"place":{"type":"string"}},"required":["place"],"additionalProperties":true},"GetOfficeHeadlinesArgs":{"type":"object","properties":{"place":{"type":"string"}},"required":["place"],"additionalProperties":true},"GetPointArgs":{"type":"object","properties":{"place":{"type":"string"}},"required":["place"],"additionalProperties":true},"GetTextProductArgs":{"type":"object","properties":{"type":{"type":"string"},"office":{"type":"string"},"id":{"type":"string"}},"additionalProperties":true},"GetWeatherRadioArgs":{"type":"object","properties":{"place":{"type":"string"},"callSign":{"type":"string"}},"additionalProperties":true},"GetWeatherStoriesArgs":{"type":"object","properties":{"place":{"type":"string"}},"required":["place"],"additionalProperties":true},"GetZoneForecastArgs":{"type":"object","properties":{"place":{"type":"string"},"kind":{"anyOf":[{"const":"forecast"},{"const":"fire"}]}},"required":["place"],"additionalProperties":true},"ListAlertTypesArgs":{"type":"object","properties":{},"additionalProperties":true},"ListSigmetsArgs":{"type":"object","properties":{"atsu":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true},"ListTextProductsArgs":{"type":"object","properties":{"office":{"type":"string"},"type":{"type":"string"},"limit":{"type":"number"}},"required":["office"],"additionalProperties":true},"LookupGlossaryArgs":{"type":"object","properties":{"term":{"type":"string"},"limit":{"type":"number"}},"required":["term"],"additionalProperties":true},"SearchAlertsArgs":{"type":"object","properties":{"place":{"type":"string"},"area":{"type":"string"},"zone":{"type":"string"},"event":{"type":"string"},"severity":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"additionalProperties":true},"SearchLocationArgs":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"],"additionalProperties":true}}}}