{"openapi":"3.1.0","info":{"title":"Wikipedia API (Bowmark)","version":"e833508f87ff","description":"The encyclopedia — read an article, its summary, sections, infobox, links, categories, images and full edit history, search across ~340 language editions, and (signed in as yourself) watch, edit and discuss pages.\n\nEvery function Bowmark has for Wikipedia (wikipedia.org) 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/wikipedia/search":{"post":{"operationId":"search","summary":"Search the encyclopedia and get back articles with id, title, url, excerpt with matches marked, description, and thumbnail where one exists.","description":"Search the encyclopedia and get back articles with id, title, url, excerpt with matches marked, description, and thumbnail where one exists.\n\nCalls `bowmark.providers.wikipedia.search`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ results: WikipediaSearchResult[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number }`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/wikipedia/suggestTitles":{"post":{"operationId":"suggestTitles","summary":"Autocomplete a partial title the way Wikipedia's search box does as you type — hand it a prefix and get back the article titles it would offer, each with its url and short description.","description":"Autocomplete a partial title the way Wikipedia's search box does as you type — hand it a prefix and get back the article titles it would offer, each with its url and short description.\n\nCalls `bowmark.providers.wikipedia.suggestTitles`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ suggestions: WikipediaTitleSuggestion[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number }`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/wikipedia/getArticle":{"post":{"operationId":"getArticle","summary":"The whole article as an agent wants to read it: title, Wikipedia's own short description, the full body as plain text with the markup gone, the canonical url, the lead image, coordinates when the subj","description":"The whole article as an agent wants to read it: title, Wikipedia's own short description, the full body as plain text with the markup gone, the canonical url, the lead image, coordinates when the subject is a place, the page id, and the id and timestamp of the revision the text came from. Takes an article title OR any wikipedia.org url and follows the site's own redirects.\n\nCalls `bowmark.providers.wikipedia.getArticle`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WikipediaArticle>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"}},"required":["titleOrUrl"],"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/wikipedia/getSummary":{"post":{"operationId":"getSummary","summary":"The lead of an article and nothing else — the first paragraph as plain text and as HTML, the short description, a thumbnail and the original image, coordinates when the subject is a place, the Wikidat","description":"The lead of an article and nothing else — the first paragraph as plain text and as HTML, the short description, a thumbnail and the original image, coordinates when the subject is a place, the Wikidata id, and the canonical url. The call for \"what is X\" where `getArticle`'s full body is far more than was asked for. Takes the same title-or-url argument as `getArticle`.\n\nCalls `bowmark.providers.wikipedia.getSummary`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WikipediaSummary>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"}},"required":["titleOrUrl"],"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/wikipedia/getSections":{"post":{"operationId":"getSections","summary":"A Wikipedia article's sections (its table of contents, outline or headings) — every section with its number, heading, nesting level and anchor, in page order.","description":"A Wikipedia article's sections (its table of contents, outline or headings) — every section with its number, heading, nesting level and anchor, in page order. What a caller reads to decide WHICH part of a long article it actually wants before pulling the text. Takes the same title-or-url argument as `getArticle` and follows the site's own redirects.\n\nCalls `bowmark.providers.wikipedia.getSections`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ sections: WikipediaSection[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"}},"required":["titleOrUrl"],"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/wikipedia/getSection":{"post":{"operationId":"getSection","summary":"The rendered HTML of one section, after the site's parser has converted wikitext to markup.","description":"The rendered HTML of one section, after the site's parser has converted wikitext to markup. Takes an article title or url and a section index (from getSections) and returns that section's HTML content with its title. Useful for getting a specific part of a long article without fetching the whole thing.\n\nCalls `bowmark.providers.wikipedia.getSection`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WikipediaSectionContent>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"sectionIndex":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"}},"required":["titleOrUrl","sectionIndex"],"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/wikipedia/getArticleHtml":{"post":{"operationId":"getArticleHtml","summary":"The article's rendered HTML — the real page body, with tables, references, footnotes and infobox markup intact, for a caller that wants to parse structure rather than read prose.","description":"The article's rendered HTML — the real page body, with tables, references, footnotes and infobox markup intact, for a caller that wants to parse structure rather than read prose. Takes an article title OR any wikipedia.org url and follows the site's own redirects.\n\nCalls `bowmark.providers.wikipedia.getArticleHtml`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WikipediaArticleHtml>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"}},"required":["titleOrUrl"],"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/wikipedia/getWikitext":{"post":{"operationId":"getWikitext","summary":"The article's raw wikitext source — the exact text an editor sees in the edit box, including all templates, transclusions, categories, links and redirects.","description":"The article's raw wikitext source — the exact text an editor sees in the edit box, including all templates, transclusions, categories, links and redirects. The input for any caller that wants to analyse, diff or programmatically change a page, and what getInfobox parses to extract infobox templates.\n\nCalls `bowmark.providers.wikipedia.getWikitext`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WikipediaWikitext>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"}},"required":["titleOrUrl"],"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/wikipedia/getInfobox":{"post":{"operationId":"getInfobox","summary":"The Wikipedia infobox from an article — the grey fact box at the top right of most articles, parsed into a key/value structure.","description":"The Wikipedia infobox from an article — the grey fact box at the top right of most articles, parsed into a key/value structure. Infoboxes contain facts like country capitals and populations, film directors and release dates, or chemical formulas. Returns the infobox's type (the template name, e.g., 'beverage', 'country') alongside its fields. `fields` keeps each value's original wikitext, and `facts` carries the same values as plain readable text (links, references, comments and common templates resolved), so read `facts` for answers and `fields` only when you need the markup. Takes an article title OR any wikipedia.org url and follows the site's own redirects.\n\nCalls `bowmark.providers.wikipedia.getInfobox`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WikipediaInfobox>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"}},"required":["titleOrUrl"],"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/wikipedia/listLinks":{"post":{"operationId":"listLinks","summary":"Every other Wikipedia article this one links to, by title and url.","description":"Every other Wikipedia article this one links to, by title and url. The outbound half of the encyclopedia's link graph, and the usual way to walk from a topic to its neighbours. Takes an article title OR any wikipedia.org url and follows the site's own redirects. Optional limit parameter caps the number of links returned (defaults to all).\n\nCalls `bowmark.providers.wikipedia.listLinks`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ links: WikipediaLink[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number }`"}},"required":["titleOrUrl"],"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/wikipedia/listBacklinks":{"post":{"operationId":"listBacklinks","summary":"What links here on Wikipedia (backlinks, incoming links) — every Wikipedia article pointing at this one, by title and url.","description":"What links here on Wikipedia (backlinks, incoming links) — every Wikipedia article pointing at this one, by title and url. The inbound half of the link graph, and the closest thing the encyclopedia has to \"how important is this topic, and to whom\". Takes an article title OR any wikipedia.org url and follows the site's own redirects. Optional limit parameter caps the number of backlinks returned (1-500); omitted, it returns up to the first 2000 and warns when the article has more.\n\nCalls `bowmark.providers.wikipedia.listBacklinks`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ backlinks: WikipediaBacklink[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number }`"}},"required":["titleOrUrl"],"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/wikipedia/listExternalLinks":{"post":{"operationId":"listExternalLinks","summary":"Every link OFF Wikipedia from one article — the sources, official sites and references the page points at, as raw urls.","description":"Every link OFF Wikipedia from one article — the sources, official sites and references the page points at, as raw urls. The cheapest way to turn 'tell me about X' into a list of primary sources about X. Takes an article title OR any wikipedia.org url and follows the site's own redirects. Optional limit parameter caps the number of links returned (defaults to 500).\n\nCalls `bowmark.providers.wikipedia.listExternalLinks`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ externalLinks: WikipediaExternalLink[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number }`"}},"required":["titleOrUrl"],"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/wikipedia/listCategories":{"post":{"operationId":"listCategories","summary":"The Wikipedia categories an article belongs to (its category list) — Wikipedia's own subject taxonomy, which is how the site says what KIND of thing this is.","description":"The Wikipedia categories an article belongs to (its category list) — Wikipedia's own subject taxonomy, which is how the site says what KIND of thing this is. `listCategoryMembers` walks the same taxonomy in the other direction. Takes an article title OR any wikipedia.org url and follows the site's own redirects. Optional limit parameter caps the number of categories returned (defaults to all).\n\nCalls `bowmark.providers.wikipedia.listCategories`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ categories: WikipediaCategory[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number }`"}},"required":["titleOrUrl"],"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/wikipedia/listCategoryMembers":{"post":{"operationId":"listCategoryMembers","summary":"Every page Wikipedia files under a category — the door `listCategories` walks in reverse.","description":"Every page Wikipedia files under a category — the door `listCategories` walks in reverse. Hand it a category name a person would say (\"Coffee preparation\") or the site's own \"Category:\" form, and get back the articles, subcategories and files filed there, each labeled by kind. A door in its own right: it reaches a whole subject area without anybody holding a title first. Optional limit parameter caps the number of members returned (defaults to all).\n\nCalls `bowmark.providers.wikipedia.listCategoryMembers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ members: WikipediaCategoryMember[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number }`"}},"required":["category"],"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/wikipedia/listRelated":{"post":{"operationId":"listRelated","summary":"Articles about things like this one — Wikipedia's own 'more like this', useful when a caller has a topic and wants its siblings rather than the articles it links to.","description":"Articles about things like this one — Wikipedia's own 'more like this', useful when a caller has a topic and wants its siblings rather than the articles it links to. Takes an article title OR any wikipedia.org url and follows the site's own redirects. Optional limit parameter caps the number of results returned (defaults to 10).\n\nCalls `bowmark.providers.wikipedia.listRelated`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ results: WikipediaSearchResult[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number }`"}},"required":["titleOrUrl"],"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/wikipedia/listLanguages":{"post":{"operationId":"listLanguages","summary":"What this article is called in every other language Wikipedia has it in, with the url of each — the door to the other ~340 editions, and the way a caller reaches an article that is fuller in German or","description":"What this article is called in every other language Wikipedia has it in, with the url of each — the door to the other ~340 editions, and the way a caller reaches an article that is fuller in German or Japanese than in English. Takes an article title OR any wikipedia.org url and follows the site's own redirects. Optional limit parameter caps the number of editions returned (defaults to all).\n\nCalls `bowmark.providers.wikipedia.listLanguages`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ languages: WikipediaLanguageLink[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number }`"}},"required":["titleOrUrl"],"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/wikipedia/listImages":{"post":{"operationId":"listImages","summary":"Every image, video and audio clip in an article, in page order — each with its file title (what getImage takes), the section it sits in, its caption as the page actually writes it, and whether it is t","description":"Every image, video and audio clip in an article, in page order — each with its file title (what getImage takes), the section it sits in, its caption as the page actually writes it, and whether it is the lead image. The door to getImage, which expands one row into the full-size url, dimensions, licence and attribution. Takes an article title OR any wikipedia.org url and follows the site's own redirects. Optional limit parameter caps the number of items returned (defaults to all).\n\nCalls `bowmark.providers.wikipedia.listImages`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ images: WikipediaMediaItem[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number }`"}},"required":["titleOrUrl"],"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/wikipedia/getImage":{"post":{"operationId":"getImage","summary":"Expands one file title listImages returned into the full-size image: its direct url, pixel dimensions, mime type, the Commons-or-local page describing it, and licence and attribution where the file ca","description":"Expands one file title listImages returned into the full-size image: its direct url, pixel dimensions, mime type, the Commons-or-local page describing it, and licence and attribution where the file carries Commons metadata. Takes the file's own title, \"File:<name>\", exactly as listImages returns it.\n\nCalls `bowmark.providers.wikipedia.getImage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WikipediaImage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fileTitle":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"}},"required":["fileTitle"],"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/wikipedia/listRevisions":{"post":{"operationId":"listRevisions","summary":"The Wikipedia edit history (revision history, page history, who edited) of an article, ordered newest-first.","description":"The Wikipedia edit history (revision history, page history, who edited) of an article, ordered newest-first. Each revision carries its id (used by getRevision, compareRevisions, and undoRevision), timestamp, editor username, edit summary comment, and byte size. The door to tracking who changed what and when. Takes an article title OR any wikipedia.org url and follows the site's own redirects. Optional limit parameter caps the number of revisions returned (defaults to 50).\n\nCalls `bowmark.providers.wikipedia.listRevisions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ revisions: WikipediaRevision[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number }`"}},"required":["titleOrUrl"],"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/wikipedia/getRevision":{"post":{"operationId":"getRevision","summary":"One specific revision of an article, keyed on the id listRevisions returns — its full wikitext source at that point in time, the editor, timestamp, edit summary, byte size and the delta from its paren","description":"One specific revision of an article, keyed on the id listRevisions returns — its full wikitext source at that point in time, the editor, timestamp, edit summary, byte size and the delta from its parent revision. What a caller uses to quote the encyclopedia as it stood on a date rather than as it stands now.\n\nCalls `bowmark.providers.wikipedia.getRevision`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WikipediaRevisionDetail>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"revisionId":{"type":"number","description":"TypeScript: `number`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"}},"required":["revisionId"],"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/wikipedia/compareRevisions":{"post":{"operationId":"compareRevisions","summary":"The diff between two revisions of the same article, keyed on ids listRevisions returns — a list of diff lines, each marked unchanged or changed, with the changed ones carrying the exact character rang","description":"The diff between two revisions of the same article, keyed on ids listRevisions returns — a list of diff lines, each marked unchanged or changed, with the changed ones carrying the exact character ranges that moved. What a caller uses to answer 'what actually changed between these two points in the article's history' without diffing the wikitext itself.\n\nCalls `bowmark.providers.wikipedia.compareRevisions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WikipediaRevisionComparison>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fromRevisionId":{"type":"number","description":"TypeScript: `number`"},"toRevisionId":{"type":"number","description":"TypeScript: `number`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"}},"required":["fromRevisionId","toRevisionId"],"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/wikipedia/listRecentChanges":{"post":{"operationId":"listRecentChanges","summary":"A live feed of recent edits across the wiki, newest first — page title, editor, timestamp, edit summary and size delta for each.","description":"A live feed of recent edits across the wiki, newest first — page title, editor, timestamp, edit summary and size delta for each. What is being changed right now. `namespace` narrows to one MediaWiki namespace (0 is articles); `anonymousOnly` filters to unregistered editors (true) or registered ones (false), leaving both when omitted.\n\nCalls `bowmark.providers.wikipedia.listRecentChanges`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ changes: WikipediaRecentChange[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"},"namespace":{"type":"number"},"anonymousOnly":{"type":"boolean"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number; namespace?: number; anonymousOnly?: boolean }`"}},"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/wikipedia/getUser":{"post":{"operationId":"getUser","summary":"A Wikipedia editor's public profile — when they registered, how many edits they have made, and what user groups they belong to (e.g., admin, autoconfirmed).","description":"A Wikipedia editor's public profile — when they registered, how many edits they have made, and what user groups they belong to (e.g., admin, autoconfirmed). Looks up one or more usernames and returns matching users in order, omitting usernames that don't exist. Username matching is exact and case-sensitive on the first character. What a caller reads to weigh who made a change in the revision history.\n\nCalls `bowmark.providers.wikipedia.getUser`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ users: WikipediaUser[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"usernames":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"TypeScript: `string | string[]`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"}},"required":["usernames"],"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/wikipedia/listUserContributions":{"post":{"operationId":"listUserContributions","summary":"Every edit one named editor has made, newest first — page title, url, timestamp, edit summary comment, and revision id.","description":"Every edit one named editor has made, newest first — page title, url, timestamp, edit summary comment, and revision id. Public by design on Wikipedia, and the other half of judging a change's provenance after calling getUser to find the username. Takes any editor's username (exact, case-sensitive on first character) and returns all their contributions. Optional limit parameter caps the number of contributions returned (1-500, defaults to 50).\n\nCalls `bowmark.providers.wikipedia.listUserContributions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ contributions: WikipediaUserContribution[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number }`"}},"required":["username"],"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/wikipedia/searchNearby":{"post":{"operationId":"searchNearby","summary":"Articles with coordinates near a point, ordered nearest first — what is written about near here.","description":"Articles with coordinates near a point, ordered nearest first — what is written about near here. Each result carries its own coordinates and distance in meters. Takes a latitude and longitude; `radius` narrows the search circle in meters (10-10000, defaults to 1000) and `limit` caps the number of results (1-500, defaults to 10). Optional `namespace` narrows to one MediaWiki namespace (0 is articles).\n\nCalls `bowmark.providers.wikipedia.searchNearby`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ places: WikipediaNearbyPlace[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"number","description":"TypeScript: `number`"},"lon":{"type":"number","description":"TypeScript: `number`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"radius":{"type":"number"},"limit":{"type":"number"},"namespace":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; radius?: number; limit?: number; namespace?: number }`"}},"required":["lat","lon"],"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/wikipedia/getPageviews":{"post":{"operationId":"getPageviews","summary":"Daily pageview counts for a Wikipedia article, optionally filtered by date range.","description":"Daily pageview counts for a Wikipedia article, optionally filtered by date range. Takes an article title or wikipedia.org url and returns an array of date/views pairs ordered chronologically. Optional `from` and `to` parameters specify a date range in ISO 8601 format (e.g., '2026-01-01'). For ranges ≤60 days, uses the Action API; for longer ranges, falls back to the Wikimedia analytics API.\n\nCalls `bowmark.providers.wikipedia.getPageviews`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ pageviews: WikipediaPageviews[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; from?: string; to?: string }`"}},"required":["titleOrUrl"],"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/wikipedia/listMostViewed":{"post":{"operationId":"listMostViewed","summary":"What Wikipedia's readers looked at most — the day's top articles with their view counts, in rank order.","description":"What Wikipedia's readers looked at most — the day's top articles with their view counts, in rank order. A genuine read on public attention. Optional `limit` caps the number of articles returned (defaults to 50); `date` (ISO 8601) picks a specific day, defaulting to yesterday (UTC). Always filters to article namespace (`Main_Page`, `Special:Search` and every colon-prefixed namespace dropped) — `namespace` must be 0 or omitted, since the underlying door has no per-row namespace to select on.\n\nCalls `bowmark.providers.wikipedia.listMostViewed`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ articles: WikipediaMostViewedArticle[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"lang":{"type":"string"},"limit":{"type":"number"},"namespace":{"type":"number"},"date":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; limit?: number; namespace?: number; date?: 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/wikipedia/getFeaturedContent":{"post":{"operationId":"getFeaturedContent","summary":"Wikipedia's own front page for a given date, as data: today's featured article with its extract and thumbnail, the day's most-read articles with view counts and rank, the picture of the day with its c","description":"Wikipedia's own front page for a given date, as data: today's featured article with its extract and thumbnail, the day's most-read articles with view counts and rank, the picture of the day with its caption and licence, and the 'In the news' items with the articles they link to. Optional `date` (ISO 8601, defaults to today in UTC) and `lang` (defaults to 'en') select the edition.\n\nCalls `bowmark.providers.wikipedia.getFeaturedContent`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ content: WikipediaFeaturedContent; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"date":{"type":"string"},"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ date?: string; lang?: 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/wikipedia/getOnThisDay":{"post":{"operationId":"getOnThisDay","summary":"Wikipedia's 'On this day' historical feed for a given date: births, deaths, events, and holidays that happened on that day throughout history.","description":"Wikipedia's 'On this day' historical feed for a given date: births, deaths, events, and holidays that happened on that day throughout history. Pass `type` to narrow to one category ('births', 'deaths', 'events', 'holidays') or request 'all' for a combined feed. Optional `type` (defaults to 'all'), `date` (ISO 8601, defaults to today in UTC), and `lang` (defaults to 'en') select the edition and content type.\n\nCalls `bowmark.providers.wikipedia.getOnThisDay`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ onThisDay: WikipediaOnThisDay; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"type":{"type":"string"},"date":{"type":"string"},"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ type?: string; date?: string; lang?: 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/wikipedia/getRandomArticle":{"post":{"operationId":"getRandomArticle","summary":"A random Wikipedia article with its summary information — title, url, description, extract, and thumbnail where one exists.","description":"A random Wikipedia article with its summary information — title, url, description, extract, and thumbnail where one exists. Each call returns a different article. Optional `lang` (defaults to 'en') selects the edition.\n\nCalls `bowmark.providers.wikipedia.getRandomArticle`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ randomArticle: WikipediaRandomArticle; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: 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/wikipedia/getCurrentUser":{"post":{"operationId":"getCurrentUser","summary":"The currently signed-in user's id, name, edit count, registration time, and block status.","description":"The currently signed-in user's id, name, edit count, registration time, and block status. The entry point to every other signed-in read here, and the cheapest proof that a session replayed at all.\n\nCalls `bowmark.providers.wikipedia.getCurrentUser`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<WikipediaCurrentUser>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/wikipedia/listWatchlist":{"post":{"operationId":"listWatchlist","summary":"The signed-in caller's watchlist — the pages they follow and recent changes to them, newest first.","description":"The signed-in caller's watchlist — the pages they follow and recent changes to them, newest first. Returns the page title, namespace, the most recent editor and edit summary, and whether that edit was minor or created a new page.\n\nCalls `bowmark.providers.wikipedia.listWatchlist`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ items: WikipediaWatchlistItem[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/wikipedia/watchPage":{"post":{"operationId":"watchPage","summary":"Add an article to the signed-in caller's watchlist so they are told when it changes.","description":"Add an article to the signed-in caller's watchlist so they are told when it changes. Takes an article title or a wikipedia.org url.\n\nCalls `bowmark.providers.wikipedia.watchPage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ watched: true; title: string; url: string; expiry?: string; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["titleOrUrl"],"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/wikipedia/unwatchPage":{"post":{"operationId":"unwatchPage","summary":"Remove an article from the signed-in caller's watchlist — the same call as `watchPage`, with the `unwatch` flag set.","description":"Remove an article from the signed-in caller's watchlist — the same call as `watchPage`, with the `unwatch` flag set.\n\nCalls `bowmark.providers.wikipedia.unwatchPage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ unwatched: true; title: string; url: string; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["titleOrUrl"],"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/wikipedia/listNotifications":{"post":{"operationId":"listNotifications","summary":"The signed-in caller's notifications — the Echo extension's alert and message feed: replies, thanks, mentions, and changes to pages they watch.","description":"The signed-in caller's notifications — the Echo extension's alert and message feed: replies, thanks, mentions, and changes to pages they watch. Returns each notification's type, category, timestamp, read status, and the page and editor it names where there is one.\n\nCalls `bowmark.providers.wikipedia.listNotifications`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ notifications: WikipediaNotification[]; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/wikipedia/editPage":{"post":{"operationId":"editPage","summary":"Change an existing article — replace its whole wikitext, or one section when `section` is given — under the signed-in caller's own account and edit summary.","description":"Change an existing article — replace its whole wikitext, or one section when `section` is given — under the signed-in caller's own account and edit summary. Only changes a page that already exists; use createPage for one that does not.\n\nCalls `bowmark.providers.wikipedia.editPage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ edited: true; title: string; url: string; revisionId: number; oldRevisionId?: number; newTimestamp?: string; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"text":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"summary":{"type":"string"},"section":{"anyOf":[{"type":"string"},{"type":"number"}]},"minor":{"type":"boolean"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; summary?: string; section?: string | number; minor?: boolean }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["titleOrUrl","text"],"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/wikipedia/createPage":{"post":{"operationId":"createPage","summary":"Create an article that does not exist yet, under the signed-in caller's own account and edit summary.","description":"Create an article that does not exist yet, under the signed-in caller's own account and edit summary. Refuses when the title already has an article — use editPage for one that does.\n\nCalls `bowmark.providers.wikipedia.createPage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ created: true; title: string; url: string; revisionId: number; newTimestamp?: string; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"TypeScript: `string`"},"text":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"summary":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; summary?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["title","text"],"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/wikipedia/undoRevision":{"post":{"operationId":"undoRevision","summary":"Reverse one revision of an article — MediaWiki's own undo, which reverts a single edit rather than restoring an old version wholesale.","description":"Reverse one revision of an article — MediaWiki's own undo, which reverts a single edit rather than restoring an old version wholesale. Takes the revision id listRevisions returns; the caller's own account and edit summary make the reversal.\n\nCalls `bowmark.providers.wikipedia.undoRevision`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ undone: true; title: string; url: string; revisionId: number; undidRevisionId: number; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"revisionId":{"type":"number","description":"TypeScript: `number`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"summary":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; summary?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["titleOrUrl","revisionId"],"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/wikipedia/postTalkMessage":{"post":{"operationId":"postTalkMessage","summary":"Post a new section to an article's Talk: page or a user's User talk: page, under the signed-in caller's own account — how discussion actually happens on Wikipedia.","description":"Post a new section to an article's Talk: page or a user's User talk: page, under the signed-in caller's own account — how discussion actually happens on Wikipedia.\n\nCalls `bowmark.providers.wikipedia.postTalkMessage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ posted: true; title: string; url: string; revisionId: number; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titleOrUrl":{"type":"string","description":"TypeScript: `string`"},"message":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"lang":{"type":"string"},"subject":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string; subject?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["titleOrUrl","message"],"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/wikipedia/thankUser":{"post":{"operationId":"thankUser","summary":"Send another editor Wikipedia's built-in \"thanks\" for a specific edit, under the signed-in caller's own account — a one-click, no-message acknowledgement the site offers on every revision.","description":"Send another editor Wikipedia's built-in \"thanks\" for a specific edit, under the signed-in caller's own account — a one-click, no-message acknowledgement the site offers on every revision. Takes the revision id listRevisions returns.\n\nCalls `bowmark.providers.wikipedia.thankUser`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ thanked: true; revisionId: number; warnings: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"revisionId":{"type":"number","description":"TypeScript: `number`"},"options":{"type":"object","properties":{"lang":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ lang?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["revisionId"],"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}}}}}}