{"openapi":"3.1.0","info":{"title":"The Weather Channel API (Bowmark)","version":"e833508f87ff","description":"Current weather conditions, forecasts, alerts, air quality, pollen, radar and tropical storms for any location.\n\nEvery function Bowmark has for The Weather Channel (weather.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/weather_channel/searchLocations":{"post":{"operationId":"searchLocations","summary":"Finds places on weather.com by name or postal code — e.g.","description":"Finds places on weather.com by name or postal code — e.g. `searchLocations(\"Toronto\")` or `searchLocations(\"10001\")` — the same lookup the site's search box runs. Returns each match with its full display name, country, coordinates and time zone. Every other function also takes a place name directly, so this is only needed to pick between ambiguous matches; an unknown place is a caller-fixable error.\n\nCalls `bowmark.providers.weather_channel.searchLocations`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WeatherLocation[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/weather_channel/searchNews":{"post":{"operationId":"searchNews","summary":"Searches weather.com articles and videos — e.g.","description":"Searches weather.com articles and videos — e.g. `searchNews(\"winter storm\")` — the same search its site search runs. Each result carries the article/video title, URL, publish date, relevance score, thumbnail URL, and for videos the watch time in minutes. `collection` names the source (articles or videos). Results are ordered by relevance.\n\nCalls `bowmark.providers.weather_channel.searchNews`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<SearchNewsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/weather_channel/getCMSContent":{"post":{"operationId":"getCMSContent","summary":"Reads one weather.com article (news, a forecast writeup, a how-to) by its URL or path — e.g.","description":"Reads one weather.com article (news, a forecast writeup, a how-to) by its URL or path — e.g. `getCMSContent(\"/2026/10/20/forecast/regional/coastal-storm-southeast-mid-atlantic\")`, typically the `url` a `searchNews()` result carries. Returns the headline, subheadline, authors, publish/update times, section, word count and lead image from the page's own article metadata, plus the body as an ordered list of heading/paragraph/list blocks. Throws if the page is not an article.\n\nCalls `bowmark.providers.weather_channel.getCMSContent`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CMSContent>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urlOrPath":{"type":"string","description":"TypeScript: `string`"}},"required":["urlOrPath"],"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/weather_channel/getLiveBlog":{"post":{"operationId":"getLiveBlog","summary":"Reads one weather.com live-updates page (the rolling coverage it runs during hurricanes and major storms) by URL or path — e.g.","description":"Reads one weather.com live-updates page (the rolling coverage it runs during hurricanes and major storms) by URL or path — e.g. `getLiveBlog(\"/2026/10/10/storms/hurricane/liveblogs/live-updates-isaias-pushes-across-southeast\")`, typically the `url` of a `searchNews()` row whose URL contains `/liveblogs/`. Returns the headline, description, authors, coverage window, and every update (headline, time, authors, permalink, full text), newest first. Use `getCMSContent` for an ordinary article; throws if the page is not a live blog.\n\nCalls `bowmark.providers.weather_channel.getLiveBlog`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<LiveBlog>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urlOrPath":{"type":"string","description":"TypeScript: `string`"}},"required":["urlOrPath"],"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/weather_channel/getLocation":{"post":{"operationId":"getLocation","summary":"Gets detailed location information for a place name, postal code, or coordinates — e.g.","description":"Gets detailed location information for a place name, postal code, or coordinates — e.g. `getLocation(\"Toronto\")`, `getLocation(\"10001\")`, or `getLocation({ latitude: 40.7, longitude: -74 })`. Returns the resolved location with its full display name, country, coordinates, time zone, and place id. A place name is resolved to weather.com's top match; an unknown place is a caller-fixable error.\n\nCalls `bowmark.providers.weather_channel.getLocation`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WeatherLocation>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"}},"required":["location"],"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/weather_channel/getCurrentConditions":{"post":{"operationId":"getCurrentConditions","summary":"The Weather Channel's current conditions for a place — e.g.","description":"The Weather Channel's current conditions for a place — e.g. `getCurrentConditions(\"Toronto\")`, `getCurrentConditions({ latitude: 40.7, longitude: -74 }, { units: \"imperial\" })`. A place name is resolved to weather.com's top match. Returns temperature, feels-like, dew point, humidity, wind speed/gust/direction, pressure, UV index, visibility, cloud cover, last-hour precipitation, the 24h high/low and sunrise/sunset. Units default to metric.\n\nCalls `bowmark.providers.weather_channel.getCurrentConditions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<CurrentConditions>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"},"options":{"$ref":"#/components/schemas/ForecastOptions","description":"TypeScript: `ForecastOptions`"}},"required":["location"],"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/weather_channel/getDailyForecast":{"post":{"operationId":"getDailyForecast","summary":"The Weather Channel's daily forecast for a place, up to 15 days — e.g.","description":"The Weather Channel's daily forecast for a place, up to 15 days — e.g. `getDailyForecast(\"London, England\", { days: 10 })`. Each day carries the high/low, the site's own narrative, precipitation and snow amounts, sunrise/sunset, moon phase, and a day and night part with chance of precipitation, wind and UV. `day` is null for today once the day part has passed. Defaults to 7 days, metric.\n\nCalls `bowmark.providers.weather_channel.getDailyForecast`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<DailyForecast>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"},"options":{"$ref":"#/components/schemas/ForecastOptions","description":"TypeScript: `ForecastOptions`"}},"required":["location"],"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/weather_channel/getHourlyForecast":{"post":{"operationId":"getHourlyForecast","summary":"The Weather Channel's hour-by-hour forecast for a place — e.g.","description":"The Weather Channel's hour-by-hour forecast for a place — e.g. `getHourlyForecast(\"Chicago\", { hours: 12 })` — up to 360 hours. Each hour carries temperature, feels-like, conditions phrase, chance/type/amount of precipitation, humidity, wind and UV. Defaults to 24 hours, metric.\n\nCalls `bowmark.providers.weather_channel.getHourlyForecast`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<HourlyForecast>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"},"options":{"$ref":"#/components/schemas/ForecastOptions","description":"TypeScript: `ForecastOptions`"}},"required":["location"],"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/weather_channel/listAlerts":{"post":{"operationId":"listAlerts","summary":"Active severe-weather alerts (warnings, watches, advisories) weather.com shows for a place — e.g.","description":"Active severe-weather alerts (warnings, watches, advisories) weather.com shows for a place — e.g. `listAlerts(\"Houston, TX\")`. Each alert carries its headline, event type, severity, urgency, certainty, the affected area, the issuing office and effective/expiry times. `alerts` empty means no active alerts, not an error; `location` is the place the name resolved to.\n\nCalls `bowmark.providers.weather_channel.listAlerts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AlertList>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"}},"required":["location"],"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/weather_channel/getAlertDetails":{"post":{"operationId":"getAlertDetails","summary":"Full details for one active weather alert — e.g.","description":"Full details for one active weather alert — e.g. `getAlertDetails(alerts[0].id)` where the ID comes from `listAlerts()`. Returns the headline, event type, full description, severity, urgency, certainty, affected area, issuing office and effective/expiry times. Throws \"No alert found\" when the ID is unknown or the alert has expired — take a fresh id from `listAlerts()`.\n\nCalls `bowmark.providers.weather_channel.getAlertDetails`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AlertDetail | null>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"alertId":{"type":"string","description":"TypeScript: `string`"}},"required":["alertId"],"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/weather_channel/getObservations":{"post":{"operationId":"getObservations","summary":"Live readings from personal weather stations near a place — e.g.","description":"Live readings from personal weather stations near a place — e.g. `getObservations(\"Toronto\")` — the same \"Weather Stations Near <city>\" widget the site shows, measured off the interactive radar map's own Personal Weather Stations overlay. Each station carries its id, neighborhood, coordinates, when it last reported, and temperature, dew point, humidity, wind speed/gust/direction, pressure, rain (last hour and today), solar radiation, UV index and elevation, all in the units the station itself reports (imperial). `stations` can be empty where no PWS network covers the area.\n\nCalls `bowmark.providers.weather_channel.getObservations`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<NearbyStationsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"}},"required":["location"],"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/weather_channel/getFifteenMinuteForecast":{"post":{"operationId":"getFifteenMinuteForecast","summary":"Sub-hourly precipitation forecast for a place — e.g.","description":"Sub-hourly precipitation forecast for a place — e.g. `getFifteenMinuteForecast(\"Seattle\")` — the same \"next hour\" minute-cast weather.com shows on its home page. Each 15-minute step carries a precipitation phrase, type, cloud cover, rain/snow QPF and chance of precipitation. Units default to metric.\n\nCalls `bowmark.providers.weather_channel.getFifteenMinuteForecast`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<FifteenMinuteForecastResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"},"options":{"$ref":"#/components/schemas/ForecastOptions","description":"TypeScript: `ForecastOptions`"}},"required":["location"],"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/weather_channel/getAirQuality":{"post":{"operationId":"getAirQuality","summary":"The Weather Channel's current air quality index for a place — e.g.","description":"The Weather Channel's current air quality index for a place — e.g. `getAirQuality(\"Los Angeles\")` — on the EPA scale. Returns the overall index and category (\"Good\", \"Moderate\", …), the primary pollutant, and a per-pollutant breakdown (CO, NO2, O3, PM10, PM2.5, SO2) with each one's amount, unit and category.\n\nCalls `bowmark.providers.weather_channel.getAirQuality`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AirQuality>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"}},"required":["location"],"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/weather_channel/getHourlyAirQuality":{"post":{"operationId":"getHourlyAirQuality","summary":"The Weather Channel's 12-hour air quality forecast for a place — e.g.","description":"The Weather Channel's 12-hour air quality forecast for a place — e.g. `getHourlyAirQuality(\"Toronto\")` — on the EPA scale, the same hourly AQI strip weather.com draws on its Today page. Each hour carries `validTimeGmt` (unix seconds), the overall index and category, the primary pollutant, and a per-pollutant breakdown (CO, NO2, O3, PM10, PM2.5, SO2) with amount, unit and category.\n\nCalls `bowmark.providers.weather_channel.getHourlyAirQuality`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<HourlyAirQuality>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"}},"required":["location"],"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/weather_channel/getAlmanac":{"post":{"operationId":"getAlmanac","summary":"Historical climate normals (5-day) for any location using weather.com's API — e.g.","description":"Historical climate normals (5-day) for any location using weather.com's API — e.g. `getAlmanac(\"Toronto\")`. Returns for each day the normal high/low temperatures, record high/low temperatures, and the years those records were set.\n\nCalls `bowmark.providers.weather_channel.getAlmanac`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AlmanacResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"}},"required":["location"],"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/weather_channel/getHistoricalHourly":{"post":{"operationId":"getHistoricalHourly","summary":"Historical hourly weather observations for a place — e.g.","description":"Historical hourly weather observations for a place — e.g. `getHistoricalHourly(\"Toronto\")` — the past 24 hours of observed conditions. Each hour carries temperature, dew point, humidity, wind speed/direction/gust, pressure, cloud ceiling (feet), rolling 24h precipitation, visibility and weather phrase.\n\nCalls `bowmark.providers.weather_channel.getHistoricalHourly`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<HistoricalHourlyResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"}},"required":["location"],"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/weather_channel/getHistoricalDaily":{"post":{"operationId":"getHistoricalDaily","summary":"Historical daily weather summaries for a place — e.g.","description":"Historical daily weather summaries for a place — e.g. `getHistoricalDaily(\"Toronto\")` — the past 30 days of actual recorded conditions. Each day carries the high/low temperature, total precipitation/rain/snow, and the day and night conditions phrase. Units default to metric.\n\nCalls `bowmark.providers.weather_channel.getHistoricalDaily`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<HistoricalDailyResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"},"options":{"$ref":"#/components/schemas/ForecastOptions","description":"TypeScript: `ForecastOptions`"}},"required":["location"],"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/weather_channel/getHistoricalDailySummary":{"post":{"operationId":"getHistoricalDailySummary","summary":"The same 30-day historical daily summary as `getHistoricalDaily` — e.g.","description":"The same 30-day historical daily summary as `getHistoricalDaily` — e.g. `getHistoricalDailySummary(\"Toronto\")` — weather.com exposes the \"past 30 days\" data through one endpoint (`conditions/historical/dailysummary/30day`) that backs both of its declared \"historical\" entry points; this is that door under its other name. Units default to metric.\n\nCalls `bowmark.providers.weather_channel.getHistoricalDailySummary`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<HistoricalDailyResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"},"options":{"$ref":"#/components/schemas/ForecastOptions","description":"TypeScript: `ForecastOptions`"}},"required":["location"],"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/weather_channel/getPollenForecast":{"post":{"operationId":"getPollenForecast","summary":"The Weather Channel's 7-day allergy forecast for a place — e.g.","description":"The Weather Channel's 7-day allergy forecast for a place — e.g. `getPollenForecast(\"Kansas City\")` — the same day/night pollen breakdown the site's allergy page shows. Each of 15 dayparts (day and night, ~7.5 days) carries the grass, tree and ragweed index (0-based site scale) and category (\"None\", \"Low\", \"Moderate\", \"High\", \"Very High\").\n\nCalls `bowmark.providers.weather_channel.getPollenForecast`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<PollenForecastResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"}},"required":["location"],"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/weather_channel/getCurrentTropicalPosition":{"post":{"operationId":"getCurrentTropicalPosition","summary":"Current position of every active tropical cyclone/hurricane worldwide — the same global list weather.com's tropical tracker shows.","description":"Current position of every active tropical cyclone/hurricane worldwide — the same global list weather.com's tropical tracker shows. Not scoped to a location: every call returns all systems currently being advised on by the issuing weather service. Each storm carries its id, name, basin, latest advisory number, position, storm type (tropical depression through hurricane/typhoon), max sustained wind, gust, minimum pressure and heading.\n\nCalls `bowmark.providers.weather_channel.getCurrentTropicalPosition`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TropicalPositionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/weather_channel/getTropicalCone":{"post":{"operationId":"getTropicalCone","summary":"Forecast track cone for active tropical systems worldwide — the uncertainty band weather.com draws around a storm's predicted path.","description":"Forecast track cone for active tropical systems worldwide — the uncertainty band weather.com draws around a storm's predicted path. Like getCurrentTropicalPosition, not scoped to a location: with no `stormId` it returns every active system's cone; pass one storm's id (from getCurrentTropicalPosition) to narrow to just that system. Each entry carries the storm's id, name, basin, current position and intensity, plus the cone polygon as `[longitude, latitude]` pairs.\n\nCalls `bowmark.providers.weather_channel.getTropicalCone`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TropicalConeResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stormId":{"type":"string","description":"TypeScript: `string`"}},"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/weather_channel/getRadarTiles":{"post":{"operationId":"getRadarTiles","summary":"The radar map layer weather.com's own map draws — the latest frame timestamps (5-minute steps, newest first) and a ready tile URL template for each.","description":"The radar map layer weather.com's own map draws — the latest frame timestamps (5-minute steps, newest first) and a ready tile URL template for each. Default layer `\"radar\"` (US/global precipitation mosaic); `availableLayers` lists the rest (`\"satrad\"`, `\"radarFcst\"`, `\"radarEurope\"`, `\"temp\"`, …). `frames` 1-50, default 12. Not scoped to a location: convert your lat/lng to slippy-map x/y at zoom ≤ `layer.nativeZoom` and fill the template.\n\nCalls `bowmark.providers.weather_channel.getRadarTiles`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RadarTilesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"layer":{"type":"string"},"frames":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ layer?: string; frames?: number }`"}},"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/weather_channel/getMinutelyPrecipitation":{"post":{"operationId":"getMinutelyPrecipitation","summary":"Minute-by-minute precipitation for the next hour — one row per minute (`time`, `precipTypeCode`, `intensityCode` 0 = none, radar `dBZ`).","description":"Minute-by-minute precipitation for the next hour — one row per minute (`time`, `precipTypeCode`, `intensityCode` 0 = none, radar `dBZ`). Measured 2026-11-07: answered for Glasgow while it rained. When the site returns nothing (dry hour, or outside coverage — US cities answered nothing) `covered` is false, `minutes` is empty and `note` says so; use getFifteenMinuteForecast or getRainTiming then.\n\nCalls `bowmark.providers.weather_channel.getMinutelyPrecipitation`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<MinutelyPrecipitationResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"}},"required":["location"],"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/weather_channel/getPlayback":{"post":{"operationId":"getPlayback","summary":"Plays one weather.com video — pass the `url` of a `searchNews()` row whose collection is `\"videos\"`.","description":"Plays one weather.com video — pass the `url` of a `searchNews()` row whose collection is `\"videos\"`. Returns the site's own MP4 in `files.muxed` (plays alone in a `<video src>`, no ads, any referrer, never expires) and the `hls` playlist (360p-1080p ladder; Safari plays it natively, elsewhere use hls.js). weather.com has no embeddable player, so `embed` is null: pick the MP4 unless the user asks for a specific resolution, then use `hls`. Throws on a page that is not a video.\n\nCalls `bowmark.providers.weather_channel.getPlayback`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<Playback>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urlOrPath":{"type":"string","description":"TypeScript: `string`"}},"required":["urlOrPath"],"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/weather_channel/getWeatherInsights":{"post":{"operationId":"getWeatherInsights","summary":"The \"anything I should know today?\" cards at the top of weather.com's Today page — e.g.","description":"The \"anything I should know today?\" cards at the top of weather.com's Today page — e.g. `{ type: \"chancePrecipInsight\", headline: \"Rain Coming\", text: \"Rain likely Wednesday afternoon\", value: \"66%\" }`, plus temperature change, sunrise, pollen and the trending video. Sorted by the site's priority, most important first. Empty `insights` when the site has nothing for the place.\n\nCalls `bowmark.providers.weather_channel.getWeatherInsights`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WeatherInsightsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"}},"required":["location"],"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/weather_channel/getPollenHealth":{"post":{"operationId":"getPollenHealth","summary":"weather.com's 5-day health-risk forecast — cold & flu risk by default, or migraine risk — one `riskLevel` per day (0 = lowest).","description":"weather.com's 5-day health-risk forecast — cold & flu risk by default, or migraine risk — one `riskLevel` per day (0 = lowest). The only two condition types the site's API accepts (measured 2026-11-07; others 400). Empty `days` with a `note` when the site has no data for the place.\n\nCalls `bowmark.providers.weather_channel.getPollenHealth`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<HealthRiskResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"},"condition":{"anyOf":[{"const":"coldAndFlu"},{"const":"migraine"}],"description":"TypeScript: `\"coldAndFlu\" | \"migraine\"`"}},"required":["location"],"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/weather_channel/getRainTiming":{"post":{"operationId":"getRainTiming","summary":"weather.com's \"when will it rain\" sentence for a place — e.g.","description":"weather.com's \"when will it rain\" sentence for a place — e.g. `getRainTiming(\"Seattle, WA\")` → `\"Rain expected around 3:45 pm.\"`, with the day and time split out (`precipDay`, `precipTime`). `overallType` 0 means dry for the next several hours.\n\nCalls `bowmark.providers.weather_channel.getRainTiming`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RainTiming>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/Location","description":"TypeScript: `Location`"}},"required":["location"],"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/weather_channel/getTropicalForecastPath":{"post":{"operationId":"getTropicalForecastPath","summary":"Where each active tropical storm/hurricane is forecast to be and how strong — one point per forecast hour (time, position, storm type, max sustained wind and gust in mph, heading and speed).","description":"Where each active tropical storm/hurricane is forecast to be and how strong — one point per forecast hour (time, position, storm type, max sustained wind and gust in mph, heading and speed). No argument returns every active system worldwide; pass a storm id from getCurrentTropicalPosition to narrow to one. Empty `storms` when nothing is active.\n\nCalls `bowmark.providers.weather_channel.getTropicalForecastPath`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TropicalForecastPathResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stormId":{"type":"string","description":"TypeScript: `string`"}},"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/weather_channel/getTropicalTrack":{"post":{"operationId":"getTropicalTrack","summary":"Where a tropical storm/hurricane HAS BEEN — every advisory position with time, storm type, category, max wind/gust (mph), pressure (inHg) and heading, plus the storm's peak.","description":"Where a tropical storm/hurricane HAS BEEN — every advisory position with time, storm type, category, max wind/gust (mph), pressure (inHg) and heading, plus the storm's peak. Pass a storm id (`\"AL132025\"`, from getCurrentTropicalPosition) for one storm, or a basin code (`\"AL\"` Atlantic, `\"EP\"`, `\"CP\"`, `\"WP\"`, `\"IO\"`, `\"SH\"`) and a year for that whole season. Empty `storms` for a season the site has nothing for.\n\nCalls `bowmark.providers.weather_channel.getTropicalTrack`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<TropicalTrackResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stormIdOrBasin":{"type":"string","description":"TypeScript: `string`"},"year":{"type":"number","description":"TypeScript: `number`"}},"required":["stormIdOrBasin"],"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}}},"ForecastOptions":{"type":"object","properties":{"units":{"anyOf":[{"const":"metric"},{"const":"imperial"}]},"days":{"type":"number"},"hours":{"type":"number"}},"additionalProperties":true},"Location":{"anyOf":[{"type":"string"},{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"required":["latitude","longitude"],"additionalProperties":true}]}}}}