{"openapi":"3.1.0","info":{"title":"Reddit API (Bowmark)","version":"bc1511aab02c","description":"Communities, threads and comment trees, and the signed-in account. Public reads need nothing: find communities, qualify one (subscribers, activity, whether you may read it), read its front page under any sort, search posts site-wide or in one community, read a thread with its full comment tree and scores, and look up users, wikis and rules. With the caller signed in to Reddit it also acts as them: their home feed, subscriptions, saved items and inbox; join, vote, save, hide; post, comment, reply, edit and delete.\n\nEvery function Bowmark has for Reddit (reddit.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/reddit/search":{"post":{"operationId":"search","summary":"Searches Reddit's posts for a phrase — across the whole site, or inside one community with `subreddit` — and returns each matching thread with its score, comment count, upvote ratio, flair, author, su","description":"Searches Reddit's posts for a phrase — across the whole site, or inside one community with `subreddit` — and returns each matching thread with its score, comment count, upvote ratio, flair, author, subreddit, age, the link or self-text it carries, and a permalink. `sort` (default relevance) and `time` (default all) come back in the result because reddit's relevance ranking is not reproducible and the window changes what `top` means. `time` is ENFORCED on every sort: a post created before the window opens is never returned, even where reddit itself ignores the window (it does under `new`), so `{sort: \"new\", time: \"day\"}` is the last 24 hours, newest first, and the walk stops at older posts — a quiet query can return fewer than `limit`, or none. `limit` is per page (max 100) and costs reddit ONE request per result (50 results is about 50 requests, so several large searches in one script can exhaust reddit's per-address limit — keep `limit` near what you will read); a result reddit refuses is left out and named in `warnings`, and the call fails only when every result is refused. Pass `nextCursor` back as `after`, unchanged, for the next page (it is opaque: reddit pages search 7 posts at a time and the cursor says where in one of its pages this call stopped). Every post's `id` is exactly what `getPost` takes. No match returns an empty `posts` array; a community that does not exist throws.\n\nCalls `bowmark.providers.reddit.search`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditSearchResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"anyOf":[{"type":"string"},{"type":"object","properties":{"query":{"type":"string"},"subreddit":{"type":"string"},"sort":{"anyOf":[{"const":"relevance"},{"const":"hot"},{"const":"top"},{"const":"new"},{"const":"comments"}]},"time":{"anyOf":[{"const":"hour"},{"const":"day"},{"const":"week"},{"const":"month"},{"const":"year"},{"const":"all"}]},"limit":{"type":"number"},"after":{"type":"string"}},"required":["query"],"additionalProperties":true}],"description":"TypeScript: `string | {query: string, subreddit?: string, sort?: \"relevance\"|\"hot\"|\"top\"|\"new\"|\"comments\", time?: \"hour\"|\"day\"|\"week\"|\"month\"|\"year\"|\"all\", limit?: number, after?: string}`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/reddit/getPost":{"post":{"operationId":"getPost","summary":"Reads one Reddit thread from a thread URL, a `t3_…` fullname or a post id: the post with its score, comment count and body, and the comment TREE — each comment nested under the one it replies to, with","description":"Reads one Reddit thread from a thread URL, a `t3_…` fullname or a post id: the post with its score, comment count and body, and the comment TREE — each comment nested under the one it replies to, with its score, author, body (plain text, as reddit renders it), depth and a permalink to that exact reply. `sort` is reddit's own comment sort (default confidence, i.e. Best); `limit` is how many comments to gather before stopping (default 100, max 500) — reddit serves a thread about 10 top-level branches at a time, so a big `limit` on a big thread is several requests. A comment's `moreReplies.count` and the thread's `moreComments.count` say how many replies are still folded; their `ids` are empty, because this door names a folded branch by an opaque cursor rather than by comment ids. A deleted author is `null`; `editedAt`, `stickied` and `distinguished` are not on this door and read `null`/`false`. Throws when the thread does not exist.\n\nCalls `bowmark.providers.reddit.getPost`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditThread>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post":{"anyOf":[{"type":"string"},{"type":"object","properties":{"post":{"type":"string"},"sort":{"anyOf":[{"const":"confidence"},{"const":"top"},{"const":"new"},{"const":"controversial"},{"const":"old"},{"const":"qa"}]},"limit":{"type":"number"}},"required":["post"],"additionalProperties":true}],"description":"TypeScript: `string | {post: string, sort?: \"confidence\"|\"top\"|\"new\"|\"controversial\"|\"old\"|\"qa\", limit?: number}`"}},"required":["post"],"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/reddit/getSubredditPosts":{"post":{"operationId":"getSubredditPosts","summary":"One community's own front page under a chosen sort (default hot), with the same per-post fields `search` returns — score, comment count, upvote ratio, flair, stickied (pinned posts sit at the top of h","description":"One community's own front page under a chosen sort (default hot), with the same per-post fields `search` returns — score, comment count, upvote ratio, flair, stickied (pinned posts sit at the top of hot). `time` applies only to top and controversial (default day) and is refused on the others. `r/all` and `r/popular` are ordinary names here. Pages of up to 100; pass `nextCursor` back as `after`. The difference from `search`: this needs no topic and answers \"what is this community talking about right now\".\n\nCalls `bowmark.providers.reddit.getSubredditPosts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditSubredditPostsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"string"},{"type":"object","properties":{"subreddit":{"type":"string"},"sort":{"anyOf":[{"const":"hot"},{"const":"new"},{"const":"top"},{"const":"rising"},{"const":"controversial"}]},"time":{"anyOf":[{"const":"hour"},{"const":"day"},{"const":"week"},{"const":"month"},{"const":"year"},{"const":"all"}]},"limit":{"type":"number"},"after":{"type":"string"}},"required":["subreddit"],"additionalProperties":true}],"description":"TypeScript: `string | {subreddit: string, sort?: \"hot\"|\"new\"|\"top\"|\"rising\"|\"controversial\", time?: \"hour\"|\"day\"|\"week\"|\"month\"|\"year\"|\"all\", limit?: number, after?: string}`"}},"required":["input"],"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/reddit/getSubreddit":{"post":{"operationId":"getSubreddit","summary":"The facts about ONE community, from \"webscraping\", \"r/webscraping\" or its URL: subscriber count, active users, title, public description and long sidebar, type (public, restricted, private…), NSFW and","description":"The facts about ONE community, from \"webscraping\", \"r/webscraping\" or its URL: subscriber count, active users, title, public description and long sidebar, type (public, restricted, private…), NSFW and quarantine flags, creation date, icon and banner, plus how alive it is — `newestPostAt` and `postsLastWeek` among its 25 newest posts. CHECK `access.readable` FIRST: a community reddit will not show you does NOT throw — `access.reason` carries reddit's own word (\"private\", \"banned\", \"quarantined\", \"gold_only\") and `info` is null. A name reddit does not know at all throws; find the real one with `searchSubreddits`.\n\nCalls `bowmark.providers.reddit.getSubreddit`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditSubredditProfile>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"TypeScript: `string`"}},"required":["name"],"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/reddit/searchSubreddits":{"post":{"operationId":"searchSubreddits","summary":"Finds Reddit communities by topic or name — the step before every other read, because the community that matters is often one you would never guess (r/buildapcsales, r/AskHistorians).","description":"Finds Reddit communities by topic or name — the step before every other read, because the community that matters is often one you would never guess (r/buildapcsales, r/AskHistorians). Each result carries its name (exactly what `getSubredditPosts` and `search({subreddit})` take), title, description, subscriber count, active users, NSFW flag, type and creation date, ranked as reddit ranks them. Pages of up to 100; pass `nextCursor` back as `after`. No match returns an empty list.\n\nCalls `bowmark.providers.reddit.searchSubreddits`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditSubredditSearchResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"anyOf":[{"type":"string"},{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"number"},"after":{"type":"string"}},"required":["query"],"additionalProperties":true}],"description":"TypeScript: `string | {query: string, limit?: number, after?: string}`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/reddit/getUser":{"post":{"operationId":"getUser","summary":"A redditor's public profile from a username, \"u/name\" or a profile URL: post, comment and total karma, when the account was made, its avatar and profile blurb, whether it is a Reddit employee, a moder","description":"A redditor's public profile from a username, \"u/name\" or a profile URL: post, comment and total karma, when the account was made, its avatar and profile blurb, whether it is a Reddit employee, a moderator somewhere, verified, premium or suspended, and the trophies on its profile. Use it to judge whether an account is a real long-standing member before trusting what it says. CHECK `state` FIRST: \"active\" carries the profile; \"suspended\" means reddit took the account down; \"not_found\" means no such account — reddit answers a deleted account and a never-existing one identically, so the two cannot be told apart. None of the three throws.\n\nCalls `bowmark.providers.reddit.getUser`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditUserProfile | RedditUserAbsent>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"TypeScript: `string`"}},"required":["name"],"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/reddit/searchUsers":{"post":{"operationId":"searchUsers","summary":"Finds redditors by name: a partial or remembered username goes in, matching accounts come out with name, karma, account age, avatar and employee/moderator/verified flags — the door to getUser, getUser","description":"Finds redditors by name: a partial or remembered username goes in, matching accounts come out with name, karma, account age, avatar and employee/moderator/verified flags — the door to getUser, getUserPosts and getUserComments when you lack the exact handle. `limit` up to 100 (default 25); pass `nextCursor` back as `after` for the next page.\n\nCalls `bowmark.providers.reddit.searchUsers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditUserSearch>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"anyOf":[{"type":"string"},{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"number"},"after":{"type":"string"}},"required":["query"],"additionalProperties":true}],"description":"TypeScript: `string | { query: string; limit?: number; after?: string }`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/reddit/getUserPosts":{"post":{"operationId":"getUserPosts","summary":"The posts one redditor has submitted, newest (default), top, hot or controversial first — each with title, subreddit, score, comment count, link and permalink.","description":"The posts one redditor has submitted, newest (default), top, hot or controversial first — each with title, subreddit, score, comment count, link and permalink. `time` applies to top and controversial (default all). `limit` up to 100; pass `nextCursor` back as `after`. The result is a RECENT WINDOW, not a complete history: reddit serves about the last 1,000 items per sort, so absence here does not mean they never posted it. A top/controversial all-time page can come back empty on a big account; `warnings` says so — try time \"year\". Throws when the account does not exist (getUser tells not-found from suspended).\n\nCalls `bowmark.providers.reddit.getUserPosts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditUserPosts>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"anyOf":[{"type":"string"},{"type":"object","properties":{"user":{"type":"string"},"sort":{"anyOf":[{"const":"new"},{"const":"top"},{"const":"hot"},{"const":"controversial"}]},"time":{"anyOf":[{"const":"hour"},{"const":"day"},{"const":"week"},{"const":"month"},{"const":"year"},{"const":"all"}]},"limit":{"type":"number"},"after":{"type":"string"}},"required":["user"],"additionalProperties":true}],"description":"TypeScript: `string | { user: string; sort?: \"new\" | \"top\" | \"hot\" | \"controversial\"; time?: \"hour\" | \"day\" | \"week\" | \"month\" | \"year\" | \"all\"; limit?: number; after?: string }`"}},"required":["user"],"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/reddit/getUserComments":{"post":{"operationId":"getUserComments","summary":"The comments one redditor has written, newest (default), top, hot or controversial first — each with body, score, subreddit, a permalink to that exact reply, and `thread`: the title, permalink, author","description":"The comments one redditor has written, newest (default), top, hot or controversial first — each with body, score, subreddit, a permalink to that exact reply, and `thread`: the title, permalink, author and comment count of the post it sits in, so a reply means something on its own. For the conversation around a comment, call getPost on `thread.id`. Same controls and the same RECENT-WINDOW limit as getUserPosts (about the last 1,000 per sort). Throws when the account does not exist.\n\nCalls `bowmark.providers.reddit.getUserComments`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditUserComments>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"anyOf":[{"type":"string"},{"type":"object","properties":{"user":{"type":"string"},"sort":{"anyOf":[{"const":"new"},{"const":"top"},{"const":"hot"},{"const":"controversial"}]},"time":{"anyOf":[{"const":"hour"},{"const":"day"},{"const":"week"},{"const":"month"},{"const":"year"},{"const":"all"}]},"limit":{"type":"number"},"after":{"type":"string"}},"required":["user"],"additionalProperties":true}],"description":"TypeScript: `string | { user: string; sort?: \"new\" | \"top\" | \"hot\" | \"controversial\"; time?: \"hour\" | \"day\" | \"week\" | \"month\" | \"year\" | \"all\"; limit?: number; after?: string }`"}},"required":["user"],"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/reddit/findPostsByUrl":{"post":{"operationId":"findPostsByUrl","summary":"Given a link — an article, a paper, a product page, a repository — returns the Reddit threads that submitted it, most-discussed first, each with subreddit, score, comment count and permalink: the fast","description":"Given a link — an article, a paper, a product page, a repository — returns the Reddit threads that submitted it, most-discussed first, each with subreddit, score, comment count and permalink: the fastest route to what Reddit said about one specific thing. Reddit stores submissions on the exact URL, so this also counts the spellings reddit treats as different (tracking parameters stripped, trailing slash toggled, http/https, with and without www.), and `matched` lists every spelling and how many threads it found. It reads Reddit's own site search for the link and keeps only exact matches, so it sees the threads among the first ~35 search candidates — a link submitted hundreds of times may not come back whole. `exact: true` asks only the URL as given. Given a Reddit thread URL instead, it returns that thread plus its 'other discussions' (the same link posted elsewhere).\n\nCalls `bowmark.providers.reddit.findPostsByUrl`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditPostsByUrl>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"anyOf":[{"type":"string"},{"type":"object","properties":{"url":{"type":"string"},"exact":{"type":"boolean"}},"required":["url"],"additionalProperties":true}],"description":"TypeScript: `string | { url: string; exact?: boolean }`"}},"required":["url"],"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/reddit/listWikiPages":{"post":{"operationId":"listWikiPages","summary":"Lists the page names of one community's wiki (`index`, `faq`, `config/sidebar`, …) — the index you need before getWikiPage, because wiki page names are not guessable.","description":"Lists the page names of one community's wiki (`index`, `faq`, `config/sidebar`, …) — the index you need before getWikiPage, because wiki page names are not guessable. CHECK `state` FIRST: \"ok\" carries `pages`; otherwise it says why there is nothing — no_such_community, community_unavailable (banned), private, or not_viewable (wiki switched off or limited to moderators/approved users; reddit does not say which). None of those throws.\n\nCalls `bowmark.providers.reddit.listWikiPages`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditWikiPages | RedditWikiAbsent>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"anyOf":[{"type":"string"},{"type":"object","properties":{"subreddit":{"type":"string"}},"required":["subreddit"],"additionalProperties":true}],"description":"TypeScript: `string | { subreddit: string }`"}},"required":["subreddit"],"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/reddit/getWikiPage":{"post":{"operationId":"getWikiPage","summary":"Returns one page of a community's wiki — the FAQ, buying guide, reading list or detailed rules a community wrote once and maintains — as markdown, with when it was last revised and by whom.","description":"Returns one page of a community's wiki — the FAQ, buying guide, reading list or detailed rules a community wrote once and maintains — as markdown, with when it was last revised and by whom. `page` defaults to \"index\"; listWikiPages lists the names. Pages can be LONG (the AskHistorians rules page is ~42 KB); `long` is true past ~20 KB and the whole text is still returned. CHECK `state` FIRST: \"ok\" carries the page; \"page_not_found\" carries `pages`, the names that do exist; no_such_community, community_unavailable, private and not_viewable say why there is nothing. None of those throws.\n\nCalls `bowmark.providers.reddit.getWikiPage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditWikiPage | RedditWikiAbsent>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"anyOf":[{"type":"string"},{"type":"object","properties":{"subreddit":{"type":"string"},"page":{"type":"string"}},"required":["subreddit"],"additionalProperties":true}],"description":"TypeScript: `string | { subreddit: string; page?: string }`"}},"required":["subreddit"],"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/reddit/getSubredditRules":{"post":{"operationId":"getSubredditRules","summary":"One community's posting rules, in the order the community ranks them: each rule's short name, full markdown description, whether it applies to posts, comments or both, and the label reddit's report me","description":"One community's posting rules, in the order the community ranks them: each rule's short name, full markdown description, whether it applies to posts, comments or both, and the label reddit's report menu uses for breaking it — plus the reddit-wide rules offered beside them. The read to do before posting, and the one that explains why a post was removed. Throws when the community does not exist, is banned or is private (the message carries reddit's own reason).\n\nCalls `bowmark.providers.reddit.getSubredditRules`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditRules>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"anyOf":[{"type":"string"},{"type":"object","properties":{"subreddit":{"type":"string"}},"required":["subreddit"],"additionalProperties":true}],"description":"TypeScript: `string | { subreddit: string }`"}},"required":["subreddit"],"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/reddit/browseSubreddits":{"post":{"operationId":"browseSubreddits","summary":"Lists communities without a query: Reddit's own most-popular (default) or newest communities, each with name, title, description, subscriber count, type and NSFW flag — the 'explore communities' page,","description":"Lists communities without a query: Reddit's own most-popular (default) or newest communities, each with name, title, description, subscriber count, type and NSFW flag — the 'explore communities' page, for learning what is big (or just started) on Reddit rather than what matches a word. `limit` up to 100; pass `nextCursor` back as `after`.\n\nCalls `bowmark.providers.reddit.browseSubreddits`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditSubredditBrowse>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list":{"anyOf":[{"const":"popular"},{"const":"new"},{"type":"object","properties":{"list":{"anyOf":[{"const":"popular"},{"const":"new"}]},"limit":{"type":"number"},"after":{"type":"string"}},"additionalProperties":true}],"description":"TypeScript: `\"popular\" | \"new\" | { list?: \"popular\" | \"new\"; limit?: number; after?: 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/reddit/getCommentReplies":{"post":{"operationId":"getCommentReplies","summary":"Expands what getPost could not return in a big thread.","description":"Expands what getPost could not return in a big thread. Pass the thread (`post`) and either: (1) the `cursor` object a previous call returned in `more.cursor`, passed back exactly as it came, or (2) a `parent` comment id for reddit's 'continue this thread' stubs (optionally provide `subreddit` to avoid an extra fetch). Get those comments back nested under the ones they answer, with author, body, score and permalink. Reddit pages a folded branch ~10 replies at a time: keep passing `more.cursor` back until `more` is null to read the whole branch.\n\nCalls `bowmark.providers.reddit.getCommentReplies`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditCommentReplies>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"post":{"type":"string"},"cursor":{"type":"object","properties":{"path":{"type":"string"},"query":{"type":"object","additionalProperties":{"type":"string"}},"cursor":{"type":"string"}},"required":["path","query","cursor"],"additionalProperties":true},"parent":{"type":"string"},"subreddit":{"type":"string"},"sort":{"anyOf":[{"const":"confidence"},{"const":"top"},{"const":"new"},{"const":"controversial"},{"const":"old"},{"const":"qa"}]}},"required":["post"],"additionalProperties":true,"description":"TypeScript: `{ post: string; cursor?: { path: string; query: Record<string, string>; cursor: string }; parent?: string; subreddit?: string; sort?: \"confidence\" | \"top\" | \"new\" | \"controversial\" | \"old\" | \"qa\" }`"}},"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/reddit/searchComments":{"post":{"operationId":"searchComments","summary":"Searches the text of COMMENTS (not posts), site-wide or inside one subreddit — each match with its body, author, score, timestamp, a permalink to that exact reply, and `thread`: the post it sits in (i","description":"Searches the text of COMMENTS (not posts), site-wide or inside one subreddit — each match with its body, author, score, timestamp, a permalink to that exact reply, and `thread`: the post it sits in (id, title, permalink, score, comment count). The read for evidence: the post asks the question, the reply holds the answer. `subreddit` (`discordapp` or `r/discordapp`) narrows the search to that one community — use it when a full-sentence site-wide search comes back off-topic. `sort` is relevance (default), new or top; a page is up to ~10 comments, and `nextCursor` passed back as `cursor` reads the next. For the conversation around a hit, call getPost on `thread.id`.\n\nCalls `bowmark.providers.reddit.searchComments`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditCommentSearch>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"anyOf":[{"type":"string"},{"type":"object","properties":{"query":{"type":"string"},"sort":{"anyOf":[{"const":"relevance"},{"const":"new"},{"const":"top"}]},"subreddit":{"type":"string"},"cursor":{"type":"string"}},"required":["query"],"additionalProperties":true}],"description":"TypeScript: `string | { query: string; sort?: \"relevance\" | \"new\" | \"top\"; subreddit?: string; cursor?: string }`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/reddit/getMyAccount":{"post":{"operationId":"getMyAccount","summary":"The signed-in caller's own Reddit account: username, karma, account age, avatar, whether they have unread mail and how much, whether they moderate anywhere, and whether the account is premium, email-v","description":"The signed-in caller's own Reddit account: username, karma, account age, avatar, whether they have unread mail and how much, whether they moderate anywhere, and whether the account is premium, email-verified or suspended. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not. Call it first to learn whose session a script is acting as.\n\nCalls `bowmark.providers.reddit.getMyAccount`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditMyAccount>`.","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/reddit/getHomeFeed":{"post":{"operationId":"getHomeFeed","summary":"The signed-in caller's own Reddit home feed: posts from the communities they joined, ranked the way Reddit ranks them for that person (sort best by default, or hot, new, top, rising; `time` only with ","description":"The signed-in caller's own Reddit home feed: posts from the communities they joined, ranked the way Reddit ranks them for that person (sort best by default, or hot, new, top, rising; `time` only with top, default day). Each post carries the caller's own vote, saved and hidden state in `viewer`. Up to 100 per page (default 25); pass `nextCursor` back as `after` for the next page, null when the feed ran out. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not. A lapsed sign-in is refused rather than read, because reddit would otherwise answer the logged-out front page.\n\nCalls `bowmark.providers.reddit.getHomeFeed`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditHomeFeed>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"sort":{"anyOf":[{"const":"best"},{"const":"hot"},{"const":"new"},{"const":"top"},{"const":"rising"}]},"time":{"anyOf":[{"const":"hour"},{"const":"day"},{"const":"week"},{"const":"month"},{"const":"year"},{"const":"all"}]},"limit":{"type":"number"},"after":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ sort?: \"best\" | \"hot\" | \"new\" | \"top\" | \"rising\"; time?: \"hour\" | \"day\" | \"week\" | \"month\" | \"year\" | \"all\"; limit?: number; after?: string }`"},"connectionOpts":{"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/reddit/listMySubscriptions":{"post":{"operationId":"listMySubscriptions","summary":"The communities the signed-in caller has joined, each with its subscriber count, description, type and the caller's own subscriber/moderator/banned state.","description":"The communities the signed-in caller has joined, each with its subscriber count, description, type and the caller's own subscriber/moderator/banned state. Up to 100 per page (default 100); pass `nextCursor` back as `after` for more. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.listMySubscriptions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditMySubscriptions>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"limit":{"type":"number"},"after":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number; after?: string }`"},"connectionOpts":{"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/reddit/listSaved":{"post":{"operationId":"listSaved","summary":"The posts and comments the signed-in caller has saved, newest save first, in one list: check each item's `kind` (\"post\" or \"comment\").","description":"The posts and comments the signed-in caller has saved, newest save first, in one list: check each item's `kind` (\"post\" or \"comment\"). A saved comment carries the title and link of the thread it is in. Up to 100 per page (default 25); pass `nextCursor` back as `after` for more. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.listSaved`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditSavedList>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"limit":{"type":"number"},"after":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number; after?: string }`"},"connectionOpts":{"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/reddit/listInbox":{"post":{"operationId":"listInbox","summary":"The signed-in caller's Reddit inbox, newest first: replies to their posts and comments, username mentions and private messages, each marked unread or not.","description":"The signed-in caller's Reddit inbox, newest first: replies to their posts and comments, username mentions and private messages, each marked unread or not. `filter` narrows it to one folder (default all). Reading does not mark anything as read. Up to 100 per page (default 25); pass `nextCursor` back as `after` for more. Reddit moved new private conversations to its chat, which this does not read. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.listInbox`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditInbox>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"filter":{"anyOf":[{"const":"all"},{"const":"unread"},{"const":"messages"},{"const":"mentions"},{"const":"comment_replies"},{"const":"post_replies"}]},"limit":{"type":"number"},"after":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ filter?: \"all\" | \"unread\" | \"messages\" | \"mentions\" | \"comment_replies\" | \"post_replies\"; limit?: number; after?: string }`"},"connectionOpts":{"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/reddit/listPostFlairs":{"post":{"operationId":"listPostFlairs","summary":"The post flairs a community offers, with the template `id` submitPost takes, their text, colours, and whether the poster may edit the text or only moderators may use one.","description":"The post flairs a community offers, with the template `id` submitPost takes, their text, colours, and whether the poster may edit the text or only moderators may use one. Many communities refuse a post without a flair, so call this first. `posterCanChoose: false` means the community does not let posters pick a flair at all (flairs is then empty). A community that does not exist is a caller-fixable not-found error. NEEDS THE CALLER SIGNED IN TO REDDIT (reddit refuses the list to a logged-out visitor); the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.listPostFlairs`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditPostFlairs>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["subreddit"],"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/reddit/joinSubreddit":{"post":{"operationId":"joinSubreddit","summary":"Joins a community as the signed-in caller, so its posts reach their home feed.","description":"Joins a community as the signed-in caller, so its posts reach their home feed. Safe to repeat: joining a community already joined changes nothing. A community that does not exist is a caller-fixable not-found error. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.joinSubreddit`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditSubscription>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["subreddit"],"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/reddit/leaveSubreddit":{"post":{"operationId":"leaveSubreddit","summary":"Leaves a community the signed-in caller has joined.","description":"Leaves a community the signed-in caller has joined. Safe to repeat: leaving one they are not in changes nothing. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.leaveSubreddit`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditSubscription>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["subreddit"],"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/reddit/savePostOrComment":{"post":{"operationId":"savePostOrComment","summary":"Saves a post or comment to the signed-in caller's Saved list (private to them).","description":"Saves a post or comment to the signed-in caller's Saved list (private to them). Takes a fullname (\"t3_…\" post, \"t1_…\" comment) or a permalink. Safe to repeat. An id reddit does not know is a caller-fixable not-found error. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.savePostOrComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditSaveResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["id"],"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/reddit/unsavePostOrComment":{"post":{"operationId":"unsavePostOrComment","summary":"Removes a post or comment from the signed-in caller's Saved list.","description":"Removes a post or comment from the signed-in caller's Saved list. Takes a fullname or a permalink. Safe to repeat. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.unsavePostOrComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditSaveResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["id"],"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/reddit/hidePost":{"post":{"operationId":"hidePost","summary":"Hides a post from the signed-in caller's feeds, or un-hides it with `hidden: false`.","description":"Hides a post from the signed-in caller's feeds, or un-hides it with `hidden: false`. Takes a post fullname (\"t3_…\") or permalink. Safe to repeat. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.hidePost`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditHideResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post":{"anyOf":[{"type":"string"},{"type":"object","properties":{"id":{"type":"string"},"hidden":{"type":"boolean"}},"required":["id"],"additionalProperties":true}],"description":"TypeScript: `string | { id: string; hidden?: boolean }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["post"],"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/reddit/vote":{"post":{"operationId":"vote","summary":"Upvotes, downvotes or clears (\"none\") the signed-in caller's vote on a post or comment.","description":"Upvotes, downvotes or clears (\"none\") the signed-in caller's vote on a post or comment. Takes a fullname (\"t3_…\", \"t1_…\") or a permalink. Safe to repeat: the same direction twice leaves one vote. Reddit ignores votes on archived posts. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.vote`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditVoteResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"id":{"type":"string"},"direction":{"anyOf":[{"const":"up"},{"const":"down"},{"const":"none"}]}},"required":["id","direction"],"additionalProperties":true,"description":"TypeScript: `{ id: string; direction: \"up\" | \"down\" | \"none\" }`"},"connectionOpts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["opts"],"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/reddit/followUser":{"post":{"operationId":"followUser","summary":"Follows a redditor as the signed-in caller, so their profile posts reach the caller's feed, or unfollows with `follow: false`.","description":"Follows a redditor as the signed-in caller, so their profile posts reach the caller's feed, or unfollows with `follow: false`. Takes a username, \"u/name\" or profile URL. A username with no account is a caller-fixable not-found error. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.followUser`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditFollowResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"anyOf":[{"type":"string"},{"type":"object","properties":{"name":{"type":"string"},"follow":{"type":"boolean"}},"required":["name"],"additionalProperties":true}],"description":"TypeScript: `string | { name: string; follow?: boolean }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["user"],"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/reddit/blockUser":{"post":{"operationId":"blockUser","summary":"Blocks a redditor for the signed-in caller, hiding their posts, comments and messages from the caller.","description":"Blocks a redditor for the signed-in caller, hiding their posts, comments and messages from the caller. Takes a username, \"u/name\" or profile URL. Reddit answers a username with no account, and the caller's own name, with the same bad-request refusal, which surfaces as a caller-fixable not-found error. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.blockUser`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditBlockResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["user"],"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/reddit/createSubreddit":{"post":{"operationId":"createSubreddit","summary":"Creates a new community the signed-in caller owns and moderates: its name (3-21 letters, digits or underscores), a short public description, and whether it is public, restricted or private (default pu","description":"Creates a new community the signed-in caller owns and moderates: its name (3-21 letters, digits or underscores), a short public description, and whether it is public, restricted or private (default public). Returns the new community's id, name and URL. A taken or invalid name comes back as reddit's own words. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.createSubreddit`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditNewCommunity>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"type":{"anyOf":[{"const":"public"},{"const":"restricted"},{"const":"private"}]},"nsfw":{"type":"boolean"}},"required":["name"],"additionalProperties":true,"description":"TypeScript: `{ name: string; description?: string; type?: \"public\" | \"restricted\" | \"private\"; nsfw?: boolean }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"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/reddit/submitPost":{"post":{"operationId":"submitPost","summary":"Posts to a community, or to the caller's own profile (`subreddit: \"u/<their username>\"`, also `u_<name>` or a profile URL), as the signed-in caller and returns the new post's id and permalink.","description":"Posts to a community, or to the caller's own profile (`subreddit: \"u/<their username>\"`, also `u_<name>` or a profile URL), as the signed-in caller and returns the new post's id and permalink. `kind` defaults from what is given: `url` → a link post, `image` (base64 + mimeType, or a public image URL; PNG, JPEG, GIF or WebP) → an image post, `crosspostOf` (a post id or URL) → a crosspost, otherwise a text post with `text` as its body. `flairId` + `flairText` pick one of the community's post flairs; `nsfw`, `spoiler` mark it; `sendReplies: false` turns off reply notifications. A community that refuses the post (its rules, its karma bar, a private source for a crosspost) answers in reddit's own words. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.submitPost`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditNewPost>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"subreddit":{"type":"string"},"title":{"type":"string"},"kind":{"anyOf":[{"const":"self"},{"const":"link"},{"const":"image"},{"const":"crosspost"}]},"text":{"type":"string"},"url":{"type":"string"},"image":{"anyOf":[{"type":"object","properties":{"base64":{"type":"string"},"mimeType":{"type":"string"}},"required":["base64","mimeType"],"additionalProperties":true},{"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":true}]},"crosspostOf":{"type":"string"},"flairId":{"type":"string"},"flairText":{"type":"string"},"nsfw":{"type":"boolean"},"spoiler":{"type":"boolean"},"sendReplies":{"type":"boolean"}},"required":["subreddit","title"],"additionalProperties":true,"description":"TypeScript: `{ subreddit: string; title: string; kind?: \"self\" | \"link\" | \"image\" | \"crosspost\"; text?: string; url?: string; image?: { base64: string; mimeType: string } | { url: string }; crosspostOf?: string; flairId?: string; flairText?: string; nsfw?: boolean; spoiler?: boolean; sendReplies?: boolean }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"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/reddit/postComment":{"post":{"operationId":"postComment","summary":"Comments on a post (its id like \"t3_1abcde\", or its URL) as the signed-in caller, in markdown, and returns the new comment with its id and permalink.","description":"Comments on a post (its id like \"t3_1abcde\", or its URL) as the signed-in caller, in markdown, and returns the new comment with its id and permalink. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.postComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditComment>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"post":{"type":"string"},"text":{"type":"string"}},"required":["post","text"],"additionalProperties":true,"description":"TypeScript: `{ post: string; text: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"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/reddit/replyToComment":{"post":{"operationId":"replyToComment","summary":"Replies to a comment (its id like \"t1_abc123\", or its permalink) as the signed-in caller, in markdown, and returns the new reply with its id and permalink.","description":"Replies to a comment (its id like \"t1_abc123\", or its permalink) as the signed-in caller, in markdown, and returns the new reply with its id and permalink. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.replyToComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditComment>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"comment":{"type":"string"},"text":{"type":"string"}},"required":["comment","text"],"additionalProperties":true,"description":"TypeScript: `{ comment: string; text: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"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/reddit/editPostOrComment":{"post":{"operationId":"editPostOrComment","summary":"Replaces the text of the signed-in caller's own text post or comment with `text` (markdown) and returns it as it now reads.","description":"Replaces the text of the signed-in caller's own text post or comment with `text` (markdown) and returns it as it now reads. A post's title cannot be edited on reddit, and link and image posts have no text to edit. Someone else's post or comment is refused in reddit's own words. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.editPostOrComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditEdited>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"thing":{"type":"string"},"text":{"type":"string"}},"required":["thing","text"],"additionalProperties":true,"description":"TypeScript: `{ thing: string; text: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"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/reddit/deletePostOrComment":{"post":{"operationId":"deletePostOrComment","summary":"Deletes the signed-in caller's own post or comment, then reads it back to prove it now shows as [deleted].","description":"Deletes the signed-in caller's own post or comment, then reads it back to prove it now shows as [deleted]. Throws when the thing does not exist, or when it still shows its author afterwards (it was not the caller's). Deleting something already deleted succeeds. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.deletePostOrComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ id: string; deleted: true }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"thing":{"anyOf":[{"type":"string"},{"type":"object","properties":{"thing":{"type":"string"}},"required":["thing"],"additionalProperties":true}],"description":"TypeScript: `string | { thing: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["thing"],"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/reddit/reportPostOrComment":{"post":{"operationId":"reportPostOrComment","summary":"Reports a post or comment as the signed-in caller.","description":"Reports a post or comment as the signed-in caller. Give exactly one reason: `rule` — one of that community's rules, by its name (read them with getSubredditRules); `siteReason` — a Reddit-wide reason, which goes to Reddit rather than the moderators; or `reason` — free text, which reaches the community's moderators where the community allows free-form reports. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.reportPostOrComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ id: string; reported: true }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"thing":{"type":"string"},"rule":{"type":"string"},"siteReason":{"type":"string"},"reason":{"type":"string"}},"required":["thing"],"additionalProperties":true,"description":"TypeScript: `{ thing: string; rule?: string; siteReason?: string; reason?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"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/reddit/sendDirectMessage":{"post":{"operationId":"sendDirectMessage","summary":"Sends a message from the signed-in caller to another redditor.","description":"Sends a message from the signed-in caller to another redditor. This is REDDIT CHAT, not the old private-message inbox: reddit's own compose page now sends a chat message request, and the legacy private-message endpoint refuses. It checks the recipient first: an account that does not exist throws not-found, and one that does not accept message requests is refused in reddit's words before anything is sent. `subject` defaults to the first line of `text`. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.sendDirectMessage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ to: string; recipientId: string; sent: true }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"to":{"type":"string"},"subject":{"type":"string"},"text":{"type":"string"}},"required":["to","text"],"additionalProperties":true,"description":"TypeScript: `{ to: string; subject?: string; text: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"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/reddit/updateProfile":{"post":{"operationId":"updateProfile","summary":"Changes the signed-in caller's public profile: `displayName` (up to 30 characters; the username itself never changes) and `about`, the profile bio (up to 200 characters).","description":"Changes the signed-in caller's public profile: `displayName` (up to 30 characters; the username itself never changes) and `about`, the profile bio (up to 200 characters). Either or both; \"\" clears one. Returns both as the profile now shows them. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.updateProfile`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<RedditProfileText>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"displayName":{"type":"string"},"about":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ displayName?: string; about?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"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/reddit/setProfilePicture":{"post":{"operationId":"setProfilePicture","summary":"Uploads an image (PNG, JPEG, GIF or WebP, as base64 + mimeType or a public image URL) as the signed-in caller's profile picture, or with `reset: true` puts back reddit's default.","description":"Uploads an image (PNG, JPEG, GIF or WebP, as base64 + mimeType or a public image URL) as the signed-in caller's profile picture, or with `reset: true` puts back reddit's default. Returns the profile picture's URL as the profile now shows it. NEEDS THE CALLER SIGNED IN TO REDDIT; the run pauses with a sign-in link when they are not.\n\nCalls `bowmark.providers.reddit.setProfilePicture`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ iconUrl: string }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"image":{"anyOf":[{"type":"object","properties":{"base64":{"type":"string"},"mimeType":{"type":"string"}},"required":["base64","mimeType"],"additionalProperties":true},{"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":true}]}},"required":["image"],"additionalProperties":true},{"type":"object","properties":{"reset":{"const":true}},"required":["reset"],"additionalProperties":true}],"description":"TypeScript: `{ image: { base64: string; mimeType: string } | { url: string } } | { reset: true }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"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/reddit/login":{"post":{"operationId":"login","summary":"Signs in with the given credentials and saves a NEW connection — every call creates one, never replacing an existing login, unless `connection` names an existing id to sign back in to (its cookies rep","description":"Signs in with the given credentials and saves a NEW connection — every call creates one, never replacing an existing login, unless `connection` names an existing id to sign back in to (its cookies replaced, its id and settings kept, a logged-out one revived). The returned `connection` is usable on the very next call in the same script or session. `warnings` names the account's other connections to this site. `username`, `password`, `totpCode` and `totpSeed` are plain values here; a caller on the run/session script surface instead passes each as a `bowmark.secret()` reference. Pass the returned `connection` id as `{ connection }` on a later signed-in call to act as this account. Optionally set `keepAlive: { everyHours }` (or `false` to turn it off) and/or `expiresAt` (an ISO date/datetime, a hard ceiling); both default to a 12-hour keep-alive and can be changed later with `bm.connections.update(id, …)`.\n\nCalls `bowmark.providers.reddit.login`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ connection: string; account: string; expiresAt: string; warnings?: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"creds":{"type":"object","properties":{"username":{"type":"string"},"password":{"type":"string"},"totpCode":{"type":"string"},"totpSeed":{"type":"string"},"keepAlive":{"anyOf":[{"type":"object","properties":{"everyHours":{"type":"number"}},"required":["everyHours"],"additionalProperties":true},{"const":false}]},"expiresAt":{"type":"string"},"connection":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `LoginInput`"}},"required":["creds"],"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/reddit/signup":{"post":{"operationId":"signup","summary":"Makes a NEW Reddit account with the person's own email and password, in a session.","description":"Makes a NEW Reddit account with the person's own email and password, in a session. Pauses with `needs_code` / `needs_phone` whenever the site wants something only the person has; continue with `confirmSignup` in the same session. Ends `signed_up` with the login saved and the credentials in the person's secrets.\n\nCalls `bowmark.providers.reddit.signup`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ status: \"needs_code\"; channel: \"email\" | \"sms\"; sentTo?: string } | { status: \"needs_phone\" } | { status: \"in_progress\"; retryAfterSeconds: number } | { status: \"signed_up\"; username: string; email: string; connection: string | null; twoFactor: \"enrolled\" | \"none\"; secrets: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"description":"TypeScript: `SignupInput`"}},"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/reddit/confirmSignup":{"post":{"operationId":"confirmSignup","summary":"Continues the sign-up `signup` started in this session with the emailed or texted `code`, the email's verification `link`, or the person's `phone`.","description":"Continues the sign-up `signup` started in this session with the emailed or texted `code`, the email's verification `link`, or the person's `phone`.\n\nCalls `bowmark.providers.reddit.confirmSignup`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ status: \"needs_code\"; channel: \"email\" | \"sms\"; sentTo?: string } | { status: \"needs_phone\" } | { status: \"in_progress\"; retryAfterSeconds: number } | { status: \"signed_up\"; username: string; email: string; connection: string | null; twoFactor: \"enrolled\" | \"none\"; secrets: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"description":"TypeScript: `SignupConfirmInput`"}},"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}}}}}}