{"openapi":"3.1.0","info":{"title":"The Guardian API (Bowmark)","version":"e833508f87ff","description":"Reads The Guardian's articles, sections, topics, reviews, live blogs and media — all logged out.\n\nEvery function Bowmark has for The Guardian (theguardian.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/theguardian_com/listSections":{"post":{"operationId":"listSections","summary":"The Guardian's own section tree, read off theguardian.com's navigation — News (US, World, Climate crisis, Environment, Business, Tech, Science…), Opinion, Sport, Culture (Film, Music, TV, Books…), Lif","description":"The Guardian's own section tree, read off theguardian.com's navigation — News (US, World, Climate crisis, Environment, Business, Tech, Science…), Opinion, Sport, Culture (Film, Music, TV, Books…), Lifestyle — each with the path listArticlesBySection takes and its sub-sections.\n\nCalls `bowmark.providers.theguardian_com.listSections`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListSectionsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/theguardian_com/listArticlesBySection":{"post":{"operationId":"listArticlesBySection","summary":"The latest Guardian articles in a section or topic tag — world, politics, sport, culture, business, environment/climate-crisis, technology, any path listSections returns — newest first, with headline,","description":"The latest Guardian articles in a section or topic tag — world, politics, sport, culture, business, environment/climate-crisis, technology, any path listSections returns — newest first, with headline, url, standfirst, byline and publish time. Default is the front page's latest.\n\nCalls `bowmark.providers.theguardian_com.listArticlesBySection`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListArticlesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianListArticlesArgs","description":"TypeScript: `GuardianListArticlesArgs`"}},"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/theguardian_com/getArticle":{"post":{"operationId":"getArticle","summary":"The full text of one Guardian news article: headline, standfirst, byline, publish time, section, tags and the body paragraph by paragraph.","description":"The full text of one Guardian news article: headline, standfirst, byline, publish time, section, tags and the body paragraph by paragraph. Takes a theguardian.com URL or the path listArticlesBySection returns as `id`.\n\nCalls `bowmark.providers.theguardian_com.getArticle`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianArticle>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"articleUrlOrId":{"type":"string","description":"TypeScript: `string`"}},"required":["articleUrlOrId"],"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/theguardian_com/listTopics":{"post":{"operationId":"listTopics","summary":"The Guardian's trending topics and tag collections — climate crisis, Ukraine, US elections, and other persistent topic pages — each with the path getTopicArticles takes.","description":"The Guardian's trending topics and tag collections — climate crisis, Ukraine, US elections, and other persistent topic pages — each with the path getTopicArticles takes.\n\nCalls `bowmark.providers.theguardian_com.listTopics`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListTopicsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/theguardian_com/getTopicArticles":{"post":{"operationId":"getTopicArticles","summary":"Articles tagged with a specific topic or collection — climate crisis, Ukraine, US elections, COVID-19, Black Lives Matter — newest first, with headline, url, standfirst, byline and publish time.","description":"Articles tagged with a specific topic or collection — climate crisis, Ukraine, US elections, COVID-19, Black Lives Matter — newest first, with headline, url, standfirst, byline and publish time. Topics are paths like 'environment/climate-crisis' or 'world/ukraine'.\n\nCalls `bowmark.providers.theguardian_com.getTopicArticles`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListArticlesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianListArticlesArgs","description":"TypeScript: `GuardianListArticlesArgs`"}},"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/theguardian_com/listBreakingNews":{"post":{"operationId":"listBreakingNews","summary":"The latest breaking news stories from The Guardian — newest first, with headline, url, summary, byline and publish time.","description":"The latest breaking news stories from The Guardian — newest first, with headline, url, summary, byline and publish time.\n\nCalls `bowmark.providers.theguardian_com.listBreakingNews`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListArticlesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/theguardian_com/listContributors":{"post":{"operationId":"listContributors","summary":"Guardian journalists and contributors whose surname starts with one letter (a-z) — each with their name and profile slug.","description":"Guardian journalists and contributors whose surname starts with one letter (a-z) — each with their name and profile slug. The letter is required: the site lists contributors one letter at a time and publishes no all-contributors page.\n\nCalls `bowmark.providers.theguardian_com.listContributors`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListContributorsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianListContributorsArgs","description":"TypeScript: `GuardianListContributorsArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/theguardian_com/getContributorArticles":{"post":{"operationId":"getContributorArticles","summary":"The latest articles by one Guardian journalist or contributor — newest first, with headline, url, standfirst, byline and publish time.","description":"The latest articles by one Guardian journalist or contributor — newest first, with headline, url, standfirst, byline and publish time. Takes the profile slug from a byline or a theguardian.com/profile/<slug> URL, e.g. 'marinahyde' or 'georgemonbiot'.\n\nCalls `bowmark.providers.theguardian_com.getContributorArticles`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListArticlesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianGetContributorArticlesArgs","description":"TypeScript: `GuardianGetContributorArticlesArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/theguardian_com/listOpinionPieces":{"post":{"operationId":"listOpinionPieces","summary":"The latest opinion and comment pieces from The Guardian — newest first, with headline, url, standfirst, byline and publish time.","description":"The latest opinion and comment pieces from The Guardian — newest first, with headline, url, standfirst, byline and publish time.\n\nCalls `bowmark.providers.theguardian_com.listOpinionPieces`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListArticlesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianListOpinionPiecesArgs","description":"TypeScript: `GuardianListOpinionPiecesArgs`"}},"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/theguardian_com/listReviews":{"post":{"operationId":"listReviews","summary":"The latest reviews from The Guardian by category (books, film, music, stage, art) — newest first, with headline, url, standfirst, byline and publish time.","description":"The latest reviews from The Guardian by category (books, film, music, stage, art) — newest first, with headline, url, standfirst, byline and publish time. Default category is 'books'.\n\nCalls `bowmark.providers.theguardian_com.listReviews`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListArticlesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianListReviewsArgs","description":"TypeScript: `GuardianListReviewsArgs`"}},"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/theguardian_com/getReview":{"post":{"operationId":"getReview","summary":"The full text of one Guardian review article: headline, standfirst, byline, publish time, section, tags and the body paragraph by paragraph.","description":"The full text of one Guardian review article: headline, standfirst, byline, publish time, section, tags and the body paragraph by paragraph. Takes a theguardian.com URL or the path listReviews returns as `id`.\n\nCalls `bowmark.providers.theguardian_com.getReview`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianArticle>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianGetReviewArgs","description":"TypeScript: `GuardianGetReviewArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/theguardian_com/listLiveBlogs":{"post":{"operationId":"listLiveBlogs","summary":"The Guardian's current rolling-coverage live blogs (breaking news, elections, sport-as-it-happens) — newest first, with headline, url, standfirst, byline and publish time.","description":"The Guardian's current rolling-coverage live blogs (breaking news, elections, sport-as-it-happens) — newest first, with headline, url, standfirst, byline and publish time.\n\nCalls `bowmark.providers.theguardian_com.listLiveBlogs`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListArticlesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianListLiveBlogsArgs","description":"TypeScript: `GuardianListLiveBlogsArgs`"}},"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/theguardian_com/getLiveBlog":{"post":{"operationId":"getLiveBlog","summary":"The full text of one Guardian live blog: headline, standfirst, byline, publish time, section, tags and the update blocks (each with title, timestamps and content).","description":"The full text of one Guardian live blog: headline, standfirst, byline, publish time, section, tags and the update blocks (each with title, timestamps and content). Takes a theguardian.com URL or the path listLiveBlogs returns as `id`.\n\nCalls `bowmark.providers.theguardian_com.getLiveBlog`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianLiveBlog>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianGetLiveBlogArgs","description":"TypeScript: `GuardianGetLiveBlogArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/theguardian_com/listPhotos":{"post":{"operationId":"listPhotos","summary":"The Guardian's current photo galleries — news-in-pictures roundups, photojournalism, fashion and lifestyle sets — newest first, with title, url and publish time.","description":"The Guardian's current photo galleries — news-in-pictures roundups, photojournalism, fashion and lifestyle sets — newest first, with title, url and publish time.\n\nCalls `bowmark.providers.theguardian_com.listPhotos`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListPhotosResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianListPhotosArgs","description":"TypeScript: `GuardianListPhotosArgs`"}},"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/theguardian_com/getPhotoGallery":{"post":{"operationId":"getPhotoGallery","summary":"The full image set of one Guardian photo gallery: headline, standfirst, byline, publish time and every image's full-resolution URL, alt text, caption and credit.","description":"The full image set of one Guardian photo gallery: headline, standfirst, byline, publish time and every image's full-resolution URL, alt text, caption and credit. Takes a theguardian.com URL or the path listPhotos returns as `id`.\n\nCalls `bowmark.providers.theguardian_com.getPhotoGallery`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianPhotoGallery>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianGetPhotoGalleryArgs","description":"TypeScript: `GuardianGetPhotoGalleryArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/theguardian_com/listVideos":{"post":{"operationId":"listVideos","summary":"The Guardian's current videos, optionally scoped to one section — sport, football, culture — newest first, with title, url, summary, byline, publish time and duration in seconds.","description":"The Guardian's current videos, optionally scoped to one section — sport, football, culture — newest first, with title, url, summary, byline, publish time and duration in seconds. Default is every section's videos.\n\nCalls `bowmark.providers.theguardian_com.listVideos`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListVideosResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianListVideosArgs","description":"TypeScript: `GuardianListVideosArgs`"}},"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/theguardian_com/getVideo":{"post":{"operationId":"getVideo","summary":"The full metadata of one Guardian video: headline, byline, publish time, section, tags and duration in seconds.","description":"The full metadata of one Guardian video: headline, byline, publish time, section, tags and duration in seconds. Takes a theguardian.com URL or the path listVideos returns as `id`.\n\nCalls `bowmark.providers.theguardian_com.getVideo`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianVideo>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"videoUrlOrId":{"type":"string","description":"TypeScript: `string`"}},"required":["videoUrlOrId"],"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/theguardian_com/listNewsletters":{"post":{"operationId":"listNewsletters","summary":"Every email newsletter The Guardian publishes — name, description, frequency, theme and which edition it targets (when the site declares one).","description":"Every email newsletter The Guardian publishes — name, description, frequency, theme and which edition it targets (when the site declares one).\n\nCalls `bowmark.providers.theguardian_com.listNewsletters`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListNewslettersResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/theguardian_com/getMostRead":{"post":{"operationId":"getMostRead","summary":"The Guardian's current site-wide most-read list — the ten articles its own readers are viewing most, with title, url, summary, byline and publish time.","description":"The Guardian's current site-wide most-read list — the ten articles its own readers are viewing most, with title, url, summary, byline and publish time.\n\nCalls `bowmark.providers.theguardian_com.getMostRead`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianMostReadResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/theguardian_com/getFootballTable":{"post":{"operationId":"getFootballTable","summary":"The current league table for one football competition — rank, played, won, drawn, lost, goals for/against, goal difference and points, one row per team.","description":"The current league table for one football competition — rank, played, won, drawn, lost, goals for/against, goal difference and points, one row per team. Default is the Premier League.\n\nCalls `bowmark.providers.theguardian_com.getFootballTable`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianGetFootballTableResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianGetFootballTableArgs","description":"TypeScript: `GuardianGetFootballTableArgs`"}},"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/theguardian_com/listFootballMatches":{"post":{"operationId":"listFootballMatches","summary":"Upcoming fixtures or played results for one football competition (or every competition at once) — teams, scores when played, venue and kickoff time.","description":"Upcoming fixtures or played results for one football competition (or every competition at once) — teams, scores when played, venue and kickoff time.\n\nCalls `bowmark.providers.theguardian_com.listFootballMatches`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListFootballMatchesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianListFootballMatchesArgs","description":"TypeScript: `GuardianListFootballMatchesArgs`"}},"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/theguardian_com/getCrossword":{"post":{"operationId":"getCrossword","summary":"One Guardian crossword puzzle's full grid and clues — number, direction, length and solution for every entry.","description":"One Guardian crossword puzzle's full grid and clues — number, direction, length and solution for every entry. Default is today's/latest quick crossword; pass `kind` for cryptic, mini, prize etc, or `number` for a specific past puzzle.\n\nCalls `bowmark.providers.theguardian_com.getCrossword`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianCrossword>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianGetCrosswordArgs","description":"TypeScript: `GuardianGetCrosswordArgs`"}},"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/theguardian_com/listPodcastEpisodes":{"post":{"operationId":"listPodcastEpisodes","summary":"Episodes of one Guardian podcast, newest first — title, summary, publish date, duration, artwork and the direct audio URL.","description":"Episodes of one Guardian podcast, newest first — title, summary, publish date, duration, artwork and the direct audio URL. Defaults to Today in Focus; pass a series path such as \"politics/series/politicsweekly\".\n\nCalls `bowmark.providers.theguardian_com.listPodcastEpisodes`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianListPodcastEpisodesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianListPodcastEpisodesArgs","description":"TypeScript: `GuardianListPodcastEpisodesArgs`"}},"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/theguardian_com/getArticleComments":{"post":{"operationId":"getArticleComments","summary":"Reader comments on one Guardian article — author, body, publish time and recommend count, newest first.","description":"Reader comments on one Guardian article — author, body, publish time and recommend count, newest first. Takes a theguardian.com URL or the `id` getArticle returns. Throws if the article was never open for comments.\n\nCalls `bowmark.providers.theguardian_com.getArticleComments`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GuardianArticleCommentsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GuardianGetArticleCommentsArgs","description":"TypeScript: `GuardianGetArticleCommentsArgs`"}},"required":["args"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Your Bowmark API key."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Bowmark-Key"}},"responses":{"NotFound":{"description":"No such site or function.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}},"schemas":{"RunEnvelope":{"type":"object","description":"What a run returns. `status` says whether the SCRIPT succeeded. A script that threw or paused for a login is still HTTP 200. Branch on `status`, not on the HTTP code.","required":["ok","status","result","logs","error","ms"],"properties":{"runId":{"type":"string","description":"Stable id for this run. Quote it in a support or `report` message."},"ok":{"type":"boolean","description":"False only when the run produced nothing usable."},"status":{"type":"string","enum":["ok","error","partial","needs_user"],"description":"`partial`: the result is real but some calls failed (see `incomplete`); `ok` stays true. `needs_user`: a person must sign in to a site first. Relay `meta.handoff.url` to them, then run again."},"egress":{"type":"string","enum":["default","link"],"description":"The egress the run was given, present only when the request asked for one. `link`: every request went through the caller's own Chrome (Bowmark Buddy)."},"result":{"description":"Whatever the script `return`ed. Any JSON value."},"logs":{"type":"array","items":{"type":"string"},"description":"Lines the script wrote with `log(...)`."},"error":{"type":["string","null"],"description":"Why the run failed, in plain words. Null on success."},"ms":{"type":"integer","description":"How long the script itself ran, in milliseconds."},"queuedMs":{"type":"integer","description":"How long the run waited for a worker before starting. Present only when it was a second or more."},"needs":{"type":"array","description":"The sign-ins this script is waiting on. Present when `status` is `needs_user`.","items":{"type":"object","required":["capability","provider","providerTitle","kind"],"properties":{"capability":{"type":"string"},"provider":{"type":"string"},"providerTitle":{"type":"string","description":"The site's name, to show a person."},"kind":{"type":"string"}}}},"incomplete":{"type":"object","description":"Present only when `status` is `partial`: which calls did not answer.","properties":{"summary":{"type":"string"},"totalCalls":{"type":"integer"}},"additionalProperties":true},"emptyHanded":{"type":"object","description":"Present when the script returned nothing while its calls returned rows, usually a filter that matched none of the site's own labels. Lists the label values the calls actually returned.","additionalProperties":true},"notes":{"type":"array","description":"Caveats a call attached to a complete answer. Never changes `status`.","items":{"type":"object","properties":{"path":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","properties":{"handoff":{"type":"object","description":"A single-use sign-in link for a person to open. Expires at `expiresAt`.","properties":{"ref":{"type":"string"},"url":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time"}}},"concurrency":{"type":"object","description":"On a 429: how many runs are in flight and when to retry.","properties":{"limit":{"type":"integer"},"inFlight":{"type":"integer"},"retryAfterSeconds":{"type":"integer"}}}},"additionalProperties":true},"notice":{"type":"object","description":"Set when the account owner has not accepted the current Terms. Relay it to them.","additionalProperties":true}}},"GuardianGetArticleCommentsArgs":{"type":"object","properties":{"articleUrlOrId":{"type":"string"},"limit":{"type":"number"}},"required":["articleUrlOrId"],"additionalProperties":true},"GuardianGetContributorArticlesArgs":{"type":"object","properties":{"contributor":{"type":"string"},"limit":{"type":"number"}},"required":["contributor"],"additionalProperties":true},"GuardianGetCrosswordArgs":{"type":"object","properties":{"kind":{"type":"string"},"number":{"type":"number"}},"additionalProperties":true},"GuardianGetFootballTableArgs":{"type":"object","properties":{"competition":{"type":"string"}},"additionalProperties":true},"GuardianGetLiveBlogArgs":{"type":"object","properties":{"liveBlogUrlOrId":{"type":"string"}},"required":["liveBlogUrlOrId"],"additionalProperties":true},"GuardianGetPhotoGalleryArgs":{"type":"object","properties":{"galleryUrlOrId":{"type":"string"}},"required":["galleryUrlOrId"],"additionalProperties":true},"GuardianGetReviewArgs":{"type":"object","properties":{"reviewUrlOrId":{"type":"string"}},"required":["reviewUrlOrId"],"additionalProperties":true},"GuardianListArticlesArgs":{"type":"object","properties":{"section":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true},"GuardianListContributorsArgs":{"type":"object","properties":{"letter":{"type":"string"},"limit":{"type":"number"}},"required":["letter"],"additionalProperties":true},"GuardianListFootballMatchesArgs":{"type":"object","properties":{"competition":{"type":"string"},"kind":{"anyOf":[{"const":"fixtures"},{"const":"results"}]}},"additionalProperties":true},"GuardianListLiveBlogsArgs":{"type":"object","properties":{"limit":{"type":"number"}},"additionalProperties":true},"GuardianListOpinionPiecesArgs":{"type":"object","properties":{"limit":{"type":"number"}},"additionalProperties":true},"GuardianListPhotosArgs":{"type":"object","properties":{"limit":{"type":"number"}},"additionalProperties":true},"GuardianListPodcastEpisodesArgs":{"type":"object","properties":{"series":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true},"GuardianListReviewsArgs":{"type":"object","properties":{"category":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true},"GuardianListVideosArgs":{"type":"object","properties":{"category":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true}}}}