{"openapi":"3.1.0","info":{"title":"Bluesky API (Bowmark)","version":"e833508f87ff","description":"Bluesky — look people up, read their profiles and posts, open whole threads, search posts, read custom feeds, lists, starter packs and what is trending, and (signed in as yourself) read your timeline, notifications and DMs, post, reply, like, repost, follow and edit your profile.\n\nEvery function Bowmark has for Bluesky (bsky.app) 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/bluesky/resolveHandle":{"post":{"operationId":"resolveHandle","summary":"Turns a Bluesky handle (e.g.","description":"Turns a Bluesky handle (e.g. \"bsky.app\", \"alice.bsky.social\", or a custom domain handle) — the name a person types or says, same as any other social handle — into its permanent DID, the id every other function in this provider accepts for \"a person\". Also accepts a DID (passed through unchanged) or a bsky.app profile URL. THROWS `blueskyInputError` on a handle the AppView cannot resolve — check the spelling with `searchUsers`.\n\nCalls `bowmark.providers.bluesky.resolveHandle`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyResolvedHandle>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string","description":"TypeScript: `string`"}},"required":["actor"],"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/bluesky/searchUsers":{"post":{"operationId":"searchUsers","summary":"Searches people by name, handle or bio words, the way the Search tab's People list does.","description":"Searches people by name, handle or bio words, the way the Search tab's People list does. Returns each match's handle, DID, display name, avatar and bio, plus a `cursor` for the next page when more results exist.\n\nCalls `bowmark.providers.bluesky.searchUsers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyUserSearchResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"anyOf":[{"type":"string"},{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["query"],"additionalProperties":true}],"description":"TypeScript: `string | { query: string; limit?: number; 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/bluesky/getProfile":{"post":{"operationId":"getProfile","summary":"One person's profile: display name, handle, bio, avatar, banner, follower/following/post counts, pinned post (as an at:// URI) and labels.","description":"One person's profile: display name, handle, bio, avatar, banner, follower/following/post counts, pinned post (as an at:// URI) and labels. Takes a handle, a DID, or a bsky.app profile URL. THROWS `blueskyInputError` on an actor the AppView cannot find — check the spelling with `searchUsers` or `resolveHandle`.\n\nCalls `bowmark.providers.bluesky.getProfile`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyProfile>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string","description":"TypeScript: `string`"}},"required":["actor"],"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/bluesky/getUserPosts":{"post":{"operationId":"getUserPosts","summary":"A person's posts, newest first, as their profile tabs show them — posts only, posts with replies, media only, or videos.","description":"A person's posts, newest first, as their profile tabs show them — posts only, posts with replies, media only, or videos. Each post carries its text, author, counts, an at:// URI for replying to or quoting it, its embed (images, an external link, a video, or a quoted post) and whether it's a repost. Takes a handle, a DID, or a bsky.app profile URL. THROWS `blueskyInputError` on an actor the AppView cannot find.\n\nCalls `bowmark.providers.bluesky.getUserPosts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyUserPosts>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"anyOf":[{"type":"string"},{"type":"object","properties":{"actor":{"type":"string"},"filter":{"anyOf":[{"const":"posts"},{"const":"postsWithReplies"},{"const":"media"},{"const":"videos"}]},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["actor"],"additionalProperties":true}],"description":"TypeScript: `string | { actor: string; filter?: \"posts\" | \"postsWithReplies\" | \"media\" | \"videos\"; limit?: number; cursor?: string }`"}},"required":["actor"],"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/bluesky/getPost":{"post":{"operationId":"getPost","summary":"One post by URL (bsky.app/profile/<handle>/post/<rkey>) or at:// URI: text, author, embeds, reply/repost/like/quote counts.","description":"One post by URL (bsky.app/profile/<handle>/post/<rkey>) or at:// URI: text, author, embeds, reply/repost/like/quote counts. THROWS `blueskyInputError` on a post URL or at:// URI the AppView cannot find — check the spelling or use `searchPosts` to find it.\n\nCalls `bowmark.providers.bluesky.getPost`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyGetPostResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"string","description":"TypeScript: `string`"}},"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/bluesky/getThread":{"post":{"operationId":"getThread","summary":"A post with its whole conversation: the parents above it and the reply tree below it, as the post page shows it.","description":"A post with its whole conversation: the parents above it and the reply tree below it, as the post page shows it. Takes a post at:// URI or bsky.app post URL. Returns the root post, an array of parent posts (if any), and an array of direct replies.\n\nCalls `bowmark.providers.bluesky.getThread`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyGetThreadResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"string","description":"TypeScript: `string`"}},"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/bluesky/getTrendingTopics":{"post":{"operationId":"getTrendingTopics","summary":"What is trending on Bluesky right now: topics and links to their search or feed pages.","description":"What is trending on Bluesky right now: topics and links to their search or feed pages. Returns each trending topic's name, display name, description and link.\n\nCalls `bowmark.providers.bluesky.getTrendingTopics`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyTrendingTopicsResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/bluesky/getTrends":{"post":{"operationId":"getTrends","summary":"The richer trending list the Explore page shows: each trend's post count, status (hot/new) and category.","description":"The richer trending list the Explore page shows: each trend's post count, status (hot/new) and category.\n\nCalls `bowmark.providers.bluesky.getTrends`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyTrendsResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/bluesky/searchPosts":{"post":{"operationId":"searchPosts","summary":"Searches all public posts by words, the way the Search tab's Posts list does — Top or Latest sort, and optional author, mentions, language, domain and date-range filters.","description":"Searches all public posts by words, the way the Search tab's Posts list does — Top or Latest sort, and optional author, mentions, language, domain and date-range filters. Returns each match's text, author, embed and counts, plus a `cursor` for the next page when more results exist.\n\nCalls `bowmark.providers.bluesky.searchPosts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskySearchPostsResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"anyOf":[{"type":"string"},{"type":"object","properties":{"query":{"type":"string"},"sort":{"anyOf":[{"const":"top"},{"const":"latest"}]},"author":{"type":"string"},"mentions":{"type":"string"},"lang":{"type":"string"},"domain":{"type":"string"},"since":{"type":"string"},"until":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["query"],"additionalProperties":true}],"description":"TypeScript: `string | { query: string; sort?: \"top\" | \"latest\"; author?: string; mentions?: string; lang?: string; domain?: string; since?: string; until?: string; limit?: number; 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/bluesky/searchFeeds":{"post":{"operationId":"searchFeeds","summary":"Finds custom feeds by words (e.g.","description":"Finds custom feeds by words (e.g. 'science', 'art'), the way the Explore tab's feed search does. Returns each feed's URI, name, creator (with handle, display name and avatar), description and like count, plus a `cursor` for the next page when more results exist.\n\nCalls `bowmark.providers.bluesky.searchFeeds`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskySearchFeedsResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"anyOf":[{"type":"string"},{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["query"],"additionalProperties":true}],"description":"TypeScript: `string | { query: string; limit?: number; 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/bluesky/getFeed":{"post":{"operationId":"getFeed","summary":"Read a custom feed's posts — Discover, What's Hot, any creator's feed, page by page.","description":"Read a custom feed's posts — Discover, What's Hot, any creator's feed, page by page. Takes a feed at:// URI or a bsky.app feed URL. Returns each post's text, author, embed and counts.\n\nCalls `bowmark.providers.bluesky.getFeed`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyFeed>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"feed":{"anyOf":[{"type":"string"},{"type":"object","properties":{"feed":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["feed"],"additionalProperties":true}],"description":"TypeScript: `string | { feed: string; limit?: number; cursor?: string }`"}},"required":["feed"],"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/bluesky/suggestUsers":{"post":{"operationId":"suggestUsers","summary":"Handle autocomplete: the accounts that best match a partial name or handle, as the compose box's @-mention picker shows them.","description":"Handle autocomplete: the accounts that best match a partial name or handle, as the compose box's @-mention picker shows them. Returns each match's handle, DID, display name and avatar.\n\nCalls `bowmark.providers.bluesky.suggestUsers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskySuggestUsersResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"anyOf":[{"type":"string"},{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"number"}},"required":["query"],"additionalProperties":true}],"description":"TypeScript: `string | { query: string; limit?: number }`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/bluesky/getPostLikes":{"post":{"operationId":"getPostLikes","summary":"Who liked a post, page by page.","description":"Who liked a post, page by page. Takes a post at:// URI or bsky.app post URL. Returns each liker's handle, DID, display name, avatar and when they liked it.\n\nCalls `bowmark.providers.bluesky.getPostLikes`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostLikesResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post":{"anyOf":[{"type":"string"},{"type":"object","properties":{"post":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["post"],"additionalProperties":true}],"description":"TypeScript: `string | { post: string; limit?: number; cursor?: string }`"}},"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/bluesky/getPostReposts":{"post":{"operationId":"getPostReposts","summary":"Who reposted a post, page by page.","description":"Who reposted a post, page by page. Takes a post at:// URI or bsky.app post URL. Returns each reposter's handle, DID, display name and avatar.\n\nCalls `bowmark.providers.bluesky.getPostReposts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostRepostsResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post":{"anyOf":[{"type":"string"},{"type":"object","properties":{"post":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["post"],"additionalProperties":true}],"description":"TypeScript: `string | { post: string; limit?: number; cursor?: string }`"}},"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/bluesky/getPostQuotes":{"post":{"operationId":"getPostQuotes","summary":"The posts that quote a given post, page by page.","description":"The posts that quote a given post, page by page. Takes a post at:// URI or bsky.app post URL. Returns each quoted post with its author, text, embed and engagement counts.\n\nCalls `bowmark.providers.bluesky.getPostQuotes`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostQuotesResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post":{"anyOf":[{"type":"string"},{"type":"object","properties":{"post":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["post"],"additionalProperties":true}],"description":"TypeScript: `string | { post: string; limit?: number; cursor?: string }`"}},"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/bluesky/getFollowers":{"post":{"operationId":"getFollowers","summary":"Who follows a person, page by page, as their profile's Followers tab shows them.","description":"Who follows a person, page by page, as their profile's Followers tab shows them. Takes a handle, a DID, or a bsky.app profile URL. Returns each follower's handle, DID, display name and avatar, the queried person's own profile summary, and a `cursor` for the next page when more results exist. THROWS `blueskyInputError` on an actor the AppView cannot find — check the spelling with `searchUsers` or `resolveHandle`.\n\nCalls `bowmark.providers.bluesky.getFollowers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyFollowersResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"anyOf":[{"type":"string"},{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["actor"],"additionalProperties":true}],"description":"TypeScript: `string | { actor: string; limit?: number; cursor?: string }`"}},"required":["actor"],"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/bluesky/getFollows":{"post":{"operationId":"getFollows","summary":"Who a person follows, page by page, as their profile's Follows tab shows them.","description":"Who a person follows, page by page, as their profile's Follows tab shows them. Takes a handle, a DID, or a bsky.app profile URL. Returns each followed account's handle, DID, display name and avatar, the queried person's own profile summary, and a `cursor` for the next page when more results exist. THROWS `blueskyInputError` on an actor the AppView cannot find — check the spelling with `searchUsers` or `resolveHandle`.\n\nCalls `bowmark.providers.bluesky.getFollows`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyFollowsResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"anyOf":[{"type":"string"},{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["actor"],"additionalProperties":true}],"description":"TypeScript: `string | { actor: string; limit?: number; cursor?: string }`"}},"required":["actor"],"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/bluesky/getRelationships":{"post":{"operationId":"getRelationships","summary":"Whether `actor` follows, or is followed by, each of `others` — the chip a profile shows for 'followed by people you follow'.","description":"Whether `actor` follows, or is followed by, each of `others` — the chip a profile shows for 'followed by people you follow'. `actor` and each entry of `others` take a handle, a DID, or a bsky.app profile URL. Returns the resolved `actor` DID plus one relationship per `other`, in the order given, each carrying the following/followedBy at:// URI or `null` when that direction has no follow. THROWS `blueskyInputError` on any identifier the AppView cannot resolve — check the spelling with `searchUsers` or `resolveHandle`.\n\nCalls `bowmark.providers.bluesky.getRelationships`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyRelationshipsResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"actor":{"type":"string"},"others":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},"required":["actor","others"],"additionalProperties":true,"description":"TypeScript: `{ actor: string; others: string | string[] }`"}},"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/bluesky/getSuggestedFollows":{"post":{"operationId":"getSuggestedFollows","summary":"Accounts bsky.app suggests alongside a given person — the 'similar accounts' list a profile shows.","description":"Accounts bsky.app suggests alongside a given person — the 'similar accounts' list a profile shows. Takes a handle, a DID, or a bsky.app profile URL. Returns each suggested account's handle, DID, display name and avatar; there is no paging, the site answers a fixed-size list. THROWS `blueskyInputError` on an actor the AppView cannot find — check the spelling with `searchUsers` or `resolveHandle`.\n\nCalls `bowmark.providers.bluesky.getSuggestedFollows`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskySuggestedFollowsResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string","description":"TypeScript: `string`"}},"required":["actor"],"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/bluesky/getSuggestedFeeds":{"post":{"operationId":"getSuggestedFeeds","summary":"Bluesky's own suggested custom feeds, as shown on the Discover and Explore pages.","description":"Bluesky's own suggested custom feeds, as shown on the Discover and Explore pages. Optionally accepts a `limit` parameter (1–100) to control the number of results. Returns each suggested feed's URI, name, creator profile, description and like count; there is no paging, the site answers a fixed-size list.\n\nCalls `bowmark.providers.bluesky.getSuggestedFeeds`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskySuggestedFeedsResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number }`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/bluesky/getFeedInfo":{"post":{"operationId":"getFeedInfo","summary":"One custom feed's details by at:// URI or bsky.app feed URL: name, creator profile, description, avatar, like count, and whether its generator is online and valid.","description":"One custom feed's details by at:// URI or bsky.app feed URL: name, creator profile, description, avatar, like count, and whether its generator is online and valid. Throws `blueskyInputError` on a feed that does not exist.\n\nCalls `bowmark.providers.bluesky.getFeedInfo`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyFeedInfo>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"feed":{"anyOf":[{"type":"string"},{"type":"object","properties":{"feed":{"type":"string"}},"required":["feed"],"additionalProperties":true}],"description":"TypeScript: `string | { feed: string }`"}},"required":["feed"],"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/bluesky/getSuggestedUsers":{"post":{"operationId":"getSuggestedUsers","summary":"Bluesky's own suggested accounts to follow, as shown during onboarding.","description":"Bluesky's own suggested accounts to follow, as shown during onboarding. Calls app.bsky.actor.getSuggestions, which is viewer-scoped: with no caller session it is an honest empty list (`count: 0`), since Bluesky has nobody to personalize suggestions for. Optionally accepts a `limit` parameter (1–100). Returns each suggested account's handle, DID, display name and avatar plus a `count`; there is no paging, the site answers a fixed-size list.\n\nCalls `bowmark.providers.bluesky.getSuggestedUsers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskySuggestedUsersResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number }`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/bluesky/getUserFeeds":{"post":{"operationId":"getUserFeeds","summary":"The custom feeds a person has made, page by page, as their profile's Feeds tab shows them.","description":"The custom feeds a person has made, page by page, as their profile's Feeds tab shows them. Takes a handle, a DID, or a bsky.app profile URL. Returns each feed's URI, name, creator profile, description and like count. THROWS `blueskyInputError` on an actor the AppView cannot find — check the spelling with `searchUsers` or `resolveHandle`.\n\nCalls `bowmark.providers.bluesky.getUserFeeds`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyUserFeedsResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"anyOf":[{"type":"string"},{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["actor"],"additionalProperties":true}],"description":"TypeScript: `string | { actor: string; limit?: number; cursor?: string }`"}},"required":["actor"],"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/bluesky/getUserLists":{"post":{"operationId":"getUserLists","summary":"The lists (curation and moderation lists) a person has made, page by page, as their profile's Lists tab shows them.","description":"The lists (curation and moderation lists) a person has made, page by page, as their profile's Lists tab shows them. Takes a handle, a DID, or a bsky.app profile URL. Returns each list's URI, name, purpose, item count, description and creator profile. THROWS `blueskyInputError` on an actor the AppView cannot find — check the spelling with `searchUsers` or `resolveHandle`.\n\nCalls `bowmark.providers.bluesky.getUserLists`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyUserListsResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"anyOf":[{"type":"string"},{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["actor"],"additionalProperties":true}],"description":"TypeScript: `string | { actor: string; limit?: number; cursor?: string }`"}},"required":["actor"],"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/bluesky/getList":{"post":{"operationId":"getList","summary":"A list's own details plus its members, page by page.","description":"A list's own details plus its members, page by page. Takes a list at:// URI or a bsky.app list URL, from `getUserLists`' own `uri` field. Returns the list's own name, purpose, item count and description plus each member's handle, DID, display name and avatar. THROWS `blueskyInputError` on a list the AppView cannot find.\n\nCalls `bowmark.providers.bluesky.getList`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyListResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list":{"anyOf":[{"type":"string"},{"type":"object","properties":{"list":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["list"],"additionalProperties":true}],"description":"TypeScript: `string | { list: string; limit?: number; cursor?: string }`"}},"required":["list"],"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/bluesky/getListFeed":{"post":{"operationId":"getListFeed","summary":"The posts from everyone on a curation list, as the list's own feed tab shows them, page by page.","description":"The posts from everyone on a curation list, as the list's own feed tab shows them, page by page. Takes a list at:// URI or a bsky.app list URL, from `getUserLists`' own `uri` field. A list the AppView cannot find answers with an empty result rather than an error.\n\nCalls `bowmark.providers.bluesky.getListFeed`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyListFeedResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list":{"anyOf":[{"type":"string"},{"type":"object","properties":{"list":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["list"],"additionalProperties":true}],"description":"TypeScript: `string | { list: string; limit?: number; cursor?: string }`"}},"required":["list"],"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/bluesky/getUserStarterPacks":{"post":{"operationId":"getUserStarterPacks","summary":"The starter packs a person has made, page by page, as their profile's Starter Packs tab shows them.","description":"The starter packs a person has made, page by page, as their profile's Starter Packs tab shows them. Takes a handle, a DID, or a bsky.app profile URL. Returns each pack's URI, name, description, the list URI holding its accounts (pass it to `getList`), joined counts and creator profile. THROWS `blueskyInputError` on an actor the AppView cannot find.\n\nCalls `bowmark.providers.bluesky.getUserStarterPacks`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyUserStarterPacksResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"anyOf":[{"type":"string"},{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["actor"],"additionalProperties":true}],"description":"TypeScript: `string | { actor: string; limit?: number; cursor?: string }`"}},"required":["actor"],"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/bluesky/getStarterPack":{"post":{"operationId":"getStarterPack","summary":"One starter pack's own details: its name, description, creator, the list URI holding its accounts (pass it to `getList`), joined counts, and a short sample of who is on it.","description":"One starter pack's own details: its name, description, creator, the list URI holding its accounts (pass it to `getList`), joined counts, and a short sample of who is on it. Takes a starter pack at:// URI or a bsky.app starter pack URL, from a row's own `uri` field in `getUserStarterPacks` or `searchStarterPacks`. THROWS `blueskyInputError` on a pack the AppView cannot find.\n\nCalls `bowmark.providers.bluesky.getStarterPack`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyStarterPackResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"starterPack":{"anyOf":[{"type":"string"},{"type":"object","properties":{"starterPack":{"type":"string"}},"required":["starterPack"],"additionalProperties":true}],"description":"TypeScript: `string | { starterPack: string }`"}},"required":["starterPack"],"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/bluesky/searchStarterPacks":{"post":{"operationId":"searchStarterPacks","summary":"Finds starter packs by words, page by page, as the site's own Search → Starter packs tab does.","description":"Finds starter packs by words, page by page, as the site's own Search → Starter packs tab does. Returns the same row shape as `getUserStarterPacks` — each pack's URI, name, description, list URI, joined counts and creator. A query matching nobody returns an empty array rather than an error.\n\nCalls `bowmark.providers.bluesky.searchStarterPacks`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyStarterPackSearchResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"anyOf":[{"type":"string"},{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["query"],"additionalProperties":true}],"description":"TypeScript: `string | { query: string; limit?: number; 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/bluesky/getLabelers":{"post":{"operationId":"getLabelers","summary":"One or more moderation services (labelers) by DID: who runs them, how many have subscribed, and — when `detailed` is true — every label they declare, with its default action and severity.","description":"One or more moderation services (labelers) by DID: who runs them, how many have subscribed, and — when `detailed` is true — every label they declare, with its default action and severity. A DID the AppView does not recognize as an active labeler is silently dropped from the result rather than erroring.\n\nCalls `bowmark.providers.bluesky.getLabelers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyLabelersResults>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dids":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"object","properties":{"dids":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"detailed":{"type":"boolean"}},"required":["dids"],"additionalProperties":true}],"description":"TypeScript: `string | string[] | { dids: string | string[]; detailed?: boolean }`"}},"required":["dids"],"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/bluesky/getMe":{"post":{"operationId":"getMe","summary":"Who the signed-in caller is: their DID, handle, email and whether it is confirmed, whether the account is active, and the PDS host their data lives on.","description":"Who the signed-in caller is: their DID, handle, email and whether it is confirmed, whether the account is active, and the PDS host their data lives on. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.getMe`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyMe>`.","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/bluesky/getTimeline":{"post":{"operationId":"getTimeline","summary":"The signed-in caller's home Following feed, newest first, page by page — the posts and reposts of everyone they follow.","description":"The signed-in caller's home Following feed, newest first, page by page — the posts and reposts of everyone they follow. Pass `cursor` from the previous page for the next. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.getTimeline`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskySignedInPostPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"limit":{"type":"number"},"cursor":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number; cursor?: 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/bluesky/getMyLikes":{"post":{"operationId":"getMyLikes","summary":"The posts the signed-in caller has liked, most recent like first, page by page.","description":"The posts the signed-in caller has liked, most recent like first, page by page. Bluesky shows an account's likes only to its owner. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired.\n\nCalls `bowmark.providers.bluesky.getMyLikes`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskySignedInPostPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"limit":{"type":"number"},"cursor":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number; cursor?: 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/bluesky/listMutedUsers":{"post":{"operationId":"listMutedUsers","summary":"The accounts the signed-in caller has muted, page by page.","description":"The accounts the signed-in caller has muted, page by page. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.listMutedUsers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskySignedInUserPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"limit":{"type":"number"},"cursor":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number; cursor?: 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/bluesky/listBlockedUsers":{"post":{"operationId":"listBlockedUsers","summary":"The accounts the signed-in caller has blocked, page by page.","description":"The accounts the signed-in caller has blocked, page by page. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.listBlockedUsers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskySignedInUserPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"limit":{"type":"number"},"cursor":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number; cursor?: 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/bluesky/listBookmarks":{"post":{"operationId":"listBookmarks","summary":"The posts the signed-in caller has saved to Bookmarks, most recently saved first, page by page.","description":"The posts the signed-in caller has saved to Bookmarks, most recently saved first, page by page. Deleted or blocked posts are left out. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired.\n\nCalls `bowmark.providers.bluesky.listBookmarks`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyBookmarkPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"limit":{"type":"number"},"cursor":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number; cursor?: 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/bluesky/listNotifications":{"post":{"operationId":"listNotifications","summary":"The signed-in caller's notifications, newest first, page by page: `reason` is like, repost, follow, mention, reply, quote, starterpack-joined and so on; `reasonSubject` is the caller's record it was a","description":"The signed-in caller's notifications, newest first, page by page: `reason` is like, repost, follow, mention, reply, quote, starterpack-joined and so on; `reasonSubject` is the caller's record it was about; `text` is the post text for mentions, replies and quotes; `isRead` and `seenAt` give the read state. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired.\n\nCalls `bowmark.providers.bluesky.listNotifications`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyNotificationPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"limit":{"type":"number"},"cursor":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number; cursor?: 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/bluesky/listConversations":{"post":{"operationId":"listConversations","summary":"The signed-in caller's direct-message conversations, most recent first, page by page: each with its members, last message, unread count and whether it is muted.","description":"The signed-in caller's direct-message conversations, most recent first, page by page: each with its members, last message, unread count and whether it is muted. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired.\n\nCalls `bowmark.providers.bluesky.listConversations`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyConversationPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"limit":{"type":"number"},"cursor":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number; cursor?: 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/bluesky/getConversation":{"post":{"operationId":"getConversation","summary":"The messages in one of the signed-in caller's DM conversations, newest first, page by page.","description":"The messages in one of the signed-in caller's DM conversations, newest first, page by page. Pass `conversationId` (from listConversations) or `with` — a handle, DID or bsky.app profile URL — to open the conversation with that person. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyInputError` for a bad id or unknown person, `blueskyError` when the saved sign-in has expired.\n\nCalls `bowmark.providers.bluesky.getConversation`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyConversationMessages>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyGetConversationArgs","description":"TypeScript: `BlueskyGetConversationArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/createPost":{"post":{"operationId":"createPost","summary":"Publishes a PUBLIC post as the signed-in caller (up to 300 characters).","description":"Publishes a PUBLIC post as the signed-in caller (up to 300 characters). Links and @handle mentions in `text` are turned into clickable facets; `langs` are BCP-47 tags like \"en\". Returns the post's at:// URI, cid and bsky.app URL — pass the URI to `deletePost` to take it back. NOT idempotent across separate calls. Images are not supported yet. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.createPost`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyCreatedRecord>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyCreatePostArgs","description":"TypeScript: `BlueskyCreatePostArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/deletePost":{"post":{"operationId":"deletePost","summary":"Deletes one of the signed-in caller's OWN posts, given its at:// URI or bsky.app post URL.","description":"Deletes one of the signed-in caller's OWN posts, given its at:// URI or bsky.app post URL. Refuses a post somebody else wrote. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.deletePost`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostActionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post":{"type":"string","description":"TypeScript: `string`"},"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/bluesky/likePost":{"post":{"operationId":"likePost","summary":"Likes a post (at:// URI or bsky.app post URL) as the signed-in caller; `undo: true` removes the caller's like.","description":"Likes a post (at:// URI or bsky.app post URL) as the signed-in caller; `undo: true` removes the caller's like. Liking an already-liked post returns the existing like with `changed: false`. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.likePost`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostActionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyPostActionArgs","description":"TypeScript: `BlueskyPostActionArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/repost":{"post":{"operationId":"repost","summary":"Reposts a post (at:// URI or bsky.app post URL) to the signed-in caller's followers; `undo: true` removes the caller's repost.","description":"Reposts a post (at:// URI or bsky.app post URL) to the signed-in caller's followers; `undo: true` removes the caller's repost. Reposting an already-reposted post returns the existing repost with `changed: false`. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.repost`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostActionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyPostActionArgs","description":"TypeScript: `BlueskyPostActionArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/bookmarkPost":{"post":{"operationId":"bookmarkPost","summary":"Saves a post (at:// URI or bsky.app post URL) to the signed-in caller's private Bookmarks; `undo: true` removes it.","description":"Saves a post (at:// URI or bsky.app post URL) to the signed-in caller's private Bookmarks; `undo: true` removes it. `uri` is always null (a bookmark is not a public record); `changed: false` when it was already in that state. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.bookmarkPost`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostActionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyPostActionArgs","description":"TypeScript: `BlueskyPostActionArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/markNotificationsRead":{"post":{"operationId":"markNotificationsRead","summary":"Marks the signed-in caller's notifications as seen up to now (or up to `seenAt`, an ISO date-time), clearing the unread count.","description":"Marks the signed-in caller's notifications as seen up to now (or up to `seenAt`, an ISO date-time), clearing the unread count. Returns the instant used. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.markNotificationsRead`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyMarkSeenResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"seenAt":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ seenAt?: 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/bluesky/updateProfile":{"post":{"operationId":"updateProfile","summary":"Changes the signed-in caller's display name (max 64 characters) and/or bio (max 256).","description":"Changes the signed-in caller's display name (max 64 characters) and/or bio (max 256). A field left out is kept, avatar and banner included; an empty string clears it. `changed: false` when nothing differed. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.updateProfile`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostActionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyUpdateProfileArgs","description":"TypeScript: `BlueskyUpdateProfileArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/sendMessage":{"post":{"operationId":"sendMessage","summary":"Sends a direct message as the signed-in caller — to a person (`to`: handle, DID or bsky.app profile URL; the conversation is found or opened) or into an existing `conversationId` from listConversation","description":"Sends a direct message as the signed-in caller — to a person (`to`: handle, DID or bsky.app profile URL; the conversation is found or opened) or into an existing `conversationId` from listConversations. Text up to 1000 characters; links and @mentions become rich text. THROWS `blueskyInputError` when the recipient does not accept messages from the caller. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.sendMessage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskySentMessage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskySendMessageArgs","description":"TypeScript: `BlueskySendMessageArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/setAvatar":{"post":{"operationId":"setAvatar","summary":"Sets the signed-in caller's profile picture from an image — an https URL or a data:image/...;base64 URI, PNG or JPEG, at most 1 MB; `banner: true` sets the header banner instead.","description":"Sets the signed-in caller's profile picture from an image — an https URL or a data:image/...;base64 URI, PNG or JPEG, at most 1 MB; `banner: true` sets the header banner instead. Display name, bio and the other image are kept. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.setAvatar`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostActionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskySetAvatarArgs","description":"TypeScript: `BlueskySetAvatarArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/createList":{"post":{"operationId":"createList","summary":"Creates a list owned by the signed-in caller — `purpose: \"curate\"` (default, a feed of people) or `\"moderate\"` (a mute/block list) — and returns its at:// URI and bsky.app URL.","description":"Creates a list owned by the signed-in caller — `purpose: \"curate\"` (default, a feed of people) or `\"moderate\"` (a mute/block list) — and returns its at:// URI and bsky.app URL. Add people with addToList. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.createList`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyCreatedRecord>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyCreateListArgs","description":"TypeScript: `BlueskyCreateListArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/addToList":{"post":{"operationId":"addToList","summary":"Adds a person (handle, DID or profile URL) to one of the signed-in caller's OWN lists (at:// URI or bsky.app list URL); `undo: true` removes them.","description":"Adds a person (handle, DID or profile URL) to one of the signed-in caller's OWN lists (at:// URI or bsky.app list URL); `undo: true` removes them. Adding someone already on the list returns the existing entry with `changed: false`. Refuses a list somebody else owns. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.addToList`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostActionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyAddToListArgs","description":"TypeScript: `BlueskyAddToListArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/createPostWithImages":{"post":{"operationId":"createPostWithImages","summary":"Publishes a post with 1-4 images as the signed-in caller — each an https URL or a data:image/...;base64 URI, PNG or JPEG, at most 1 MB, with optional `alt` text — plus optional text (300 characters; l","description":"Publishes a post with 1-4 images as the signed-in caller — each an https URL or a data:image/...;base64 URI, PNG or JPEG, at most 1 MB, with optional `alt` text — plus optional text (300 characters; links and @mentions become rich text). Returns the post's at:// URI and bsky.app URL. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.createPostWithImages`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyCreatedRecord>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyCreatePostWithImagesArgs","description":"TypeScript: `BlueskyCreatePostWithImagesArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/pinPost":{"post":{"operationId":"pinPost","summary":"Pins one of the signed-in caller's OWN posts (at:// URI or bsky.app post URL) to the top of their profile, replacing any pinned post; `undo: true` unpins it.","description":"Pins one of the signed-in caller's OWN posts (at:// URI or bsky.app post URL) to the top of their profile, replacing any pinned post; `undo: true` unpins it. Pinning the post already pinned returns `changed: false`. Display name, bio and images are kept. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.pinPost`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostActionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyPostActionArgs","description":"TypeScript: `BlueskyPostActionArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/deleteList":{"post":{"operationId":"deleteList","summary":"Deletes one of the signed-in caller's OWN lists (at:// URI or bsky.app list URL), with its member entries, as the app's Delete list does.","description":"Deletes one of the signed-in caller's OWN lists (at:// URI or bsky.app list URL), with its member entries, as the app's Delete list does. Refuses a list somebody else owns. Cannot be undone. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.deleteList`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostActionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyDeleteListArgs","description":"TypeScript: `BlueskyDeleteListArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/muteWord":{"post":{"operationId":"muteWord","summary":"Mutes a word, phrase or #tag for the signed-in caller — `targets` [\"content\", \"tag\"] (default both), optional `excludeFollowing` and `expiresAt` — so matching posts are hidden; `undo: true` unmutes it","description":"Mutes a word, phrase or #tag for the signed-in caller — `targets` [\"content\", \"tag\"] (default both), optional `excludeFollowing` and `expiresAt` — so matching posts are hidden; `undo: true` unmutes it. A word already muted returns `changed: false`. Other preferences are kept. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.muteWord`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyMuteWordResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyMuteWordArgs","description":"TypeScript: `BlueskyMuteWordArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/muteThread":{"post":{"operationId":"muteThread","summary":"Mutes the thread a post sits in for the signed-in caller, so its replies stop reaching their notifications, as the app's Mute thread does.","description":"Mutes the thread a post sits in for the signed-in caller, so its replies stop reaching their notifications, as the app's Mute thread does. The post is an at:// URI or bsky.app post URL; naming a reply mutes the thread's root. `undo: true` unmutes it. A thread already in the requested state returns `changed: false`. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.muteThread`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyThreadMuteResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyMuteThreadArgs","description":"TypeScript: `BlueskyMuteThreadArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/muteConversation":{"post":{"operationId":"muteConversation","summary":"Mutes a direct or group chat for the signed-in caller, so its new messages stop notifying them, as the app's mute does; `undo: true` unmutes it.","description":"Mutes a direct or group chat for the signed-in caller, so its new messages stop notifying them, as the app's mute does; `undo: true` unmutes it. Takes a `conversationId` from listConversations, or `with` a handle, DID or bsky.app profile URL to find the conversation with that person (opened if none exists, as getConversation does). Returns whether the conversation is muted once the call returns. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.muteConversation`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyConversationMuteResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyMuteConversationArgs","description":"TypeScript: `BlueskyMuteConversationArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/leaveConversation":{"post":{"operationId":"leaveConversation","summary":"Leaves a conversation for the signed-in caller, so it stops being among their chats.","description":"Leaves a conversation for the signed-in caller, so it stops being among their chats. Takes a `conversationId` from listConversations. There is no undo from this function. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.leaveConversation`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyLeftConversation>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyLeaveConversationArgs","description":"TypeScript: `BlueskyLeaveConversationArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/muteModerationList":{"post":{"operationId":"muteModerationList","summary":"Mutes a moderation list for the signed-in caller, so the accounts on it are hidden from their feeds and notifications; `undo: true` unmutes it.","description":"Mutes a moderation list for the signed-in caller, so the accounts on it are hidden from their feeds and notifications; `undo: true` unmutes it. Takes the list as an at:// URI or bsky.app list URL. A curation list is refused, since only moderation lists can be muted. A list already in the requested state returns `changed: false`. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.muteModerationList`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyModerationListMuteResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyMuteModerationListArgs","description":"TypeScript: `BlueskyMuteModerationListArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/blockModerationList":{"post":{"operationId":"blockModerationList","summary":"Blocks a moderation list for the signed-in caller, so every account on it is blocked from interacting with them; `undo: true` unblocks it.","description":"Blocks a moderation list for the signed-in caller, so every account on it is blocked from interacting with them; `undo: true` unblocks it. Takes the list as an at:// URI or bsky.app list URL. A curation list is refused, since only moderation lists can be blocked. A list already in the requested state returns `changed: false`. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.blockModerationList`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyModerationListBlockResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyBlockModerationListArgs","description":"TypeScript: `BlueskyBlockModerationListArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/createPostWithVideo":{"post":{"operationId":"createPostWithVideo","summary":"Posts one video, with optional text, alt text and languages.","description":"Posts one video, with optional text, alt text and languages. The video is an https URL of an MP4, WebM, MPEG or QuickTime file, at most 300 MB; it is uploaded through the video service and the post embeds it. A video still processing after two minutes is not posted, and the error names its job. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.createPostWithVideo`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyCreatedRecord>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyVideoPostArgs","description":"TypeScript: `BlueskyVideoPostArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/listModerationLists":{"post":{"operationId":"listModerationLists","summary":"One page of the moderation lists the signed-in caller subscribes to: `kind: \"mute\"` (the default) for the lists they mute, `kind: \"block\"` for the lists they block.","description":"One page of the moderation lists the signed-in caller subscribes to: `kind: \"mute\"` (the default) for the lists they mute, `kind: \"block\"` for the lists they block. Each list's `uri` passes straight to muteModerationList. The cursor belongs to the chosen kind. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.listModerationLists`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyModerationListPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"kind":{"anyOf":[{"const":"mute"},{"const":"block"}]},"limit":{"type":"number"},"cursor":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ kind?: \"mute\" | \"block\"; limit?: number; cursor?: 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/bluesky/setReplyRestriction":{"post":{"operationId":"setReplyRestriction","summary":"Sets who may reply to one of the caller's own thread-root posts.","description":"Sets who may reply to one of the caller's own thread-root posts. `allow: \"everyone\"` lifts the restriction, `allow: \"nobody\"` closes replies, and `allow: [\"mentioned\", \"followers\", \"following\", <list URI>]` (up to five) admits the named groups. A reply is refused, naming its root post. Existing hidden replies are kept. A post already in the requested state returns `changed: false`. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.setReplyRestriction`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyReplyRestrictionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskySetReplyRestrictionArgs","description":"TypeScript: `BlueskySetReplyRestrictionArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/listMutedWords":{"post":{"operationId":"listMutedWords","summary":"Lists the words and #tags the signed-in caller has muted, with what each applies to and when it expires.","description":"Lists the words and #tags the signed-in caller has muted, with what each applies to and when it expires. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.listMutedWords`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyMutedWordList>`.","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/bluesky/saveFeed":{"post":{"operationId":"saveFeed","summary":"Saves a custom feed (at:// URI or bsky.app feed URL) to the signed-in caller's feeds; `pinned: true` also pins it to the home tabs, `pinned: false` unpins it, `undo: true` removes it.","description":"Saves a custom feed (at:// URI or bsky.app feed URL) to the signed-in caller's feeds; `pinned: true` also pins it to the home tabs, `pinned: false` unpins it, `undo: true` removes it. Returns the feed's resulting state. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.saveFeed`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskySaveFeedResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskySaveFeedArgs","description":"TypeScript: `BlueskySaveFeedArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/followUser":{"post":{"operationId":"followUser","summary":"Follows a person (handle, DID or bsky.app profile URL) as the signed-in caller; `undo: true` unfollows.","description":"Follows a person (handle, DID or bsky.app profile URL) as the signed-in caller; `undo: true` unfollows. Following someone already followed returns the existing follow record with `changed: false`. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.followUser`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostActionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyActorActionArgs","description":"TypeScript: `BlueskyActorActionArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/muteUser":{"post":{"operationId":"muteUser","summary":"Mutes a person (handle, DID or bsky.app profile URL) for the signed-in caller — private, they are not told; `undo: true` unmutes.","description":"Mutes a person (handle, DID or bsky.app profile URL) for the signed-in caller — private, they are not told; `undo: true` unmutes. `uri` is always null (a mute is not a public record); `changed: false` when it was already in that state. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.muteUser`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostActionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyActorActionArgs","description":"TypeScript: `BlueskyActorActionArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/blockUser":{"post":{"operationId":"blockUser","summary":"Blocks a person (handle, DID or bsky.app profile URL) as the signed-in caller — a public block record; `undo: true` unblocks.","description":"Blocks a person (handle, DID or bsky.app profile URL) as the signed-in caller — a public block record; `undo: true` unblocks. Blocking someone already blocked returns the existing block with `changed: false`. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.blockUser`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyPostActionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyActorActionArgs","description":"TypeScript: `BlueskyActorActionArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/replyToPost":{"post":{"operationId":"replyToPost","summary":"Replies to a post (at:// URI or bsky.app post URL) as the signed-in caller, threaded under it.","description":"Replies to a post (at:// URI or bsky.app post URL) as the signed-in caller, threaded under it. `root`/`parent` are resolved automatically — replying to a reply threads under the whole conversation's own root. Links and @handle mentions in `text` are turned into clickable facets, same as `createPost`. Returns the new reply's at:// URI, cid and bsky.app URL. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.replyToPost`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyCreatedRecord>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyReplyToPostArgs","description":"TypeScript: `BlueskyReplyToPostArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/quotePost":{"post":{"operationId":"quotePost","summary":"Quote-posts a post (at:// URI or bsky.app post URL) as the signed-in caller, with the caller's own `text` on top of it.","description":"Quote-posts a post (at:// URI or bsky.app post URL) as the signed-in caller, with the caller's own `text` on top of it. Links and @handle mentions in `text` are turned into clickable facets, same as `createPost`. Returns the new quote post's at:// URI, cid and bsky.app URL. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyError` when the saved sign-in has expired; sign in again.\n\nCalls `bowmark.providers.bluesky.quotePost`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyCreatedRecord>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/BlueskyQuotePostArgs","description":"TypeScript: `BlueskyQuotePostArgs`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/bluesky/getKnownFollowers":{"post":{"operationId":"getKnownFollowers","summary":"Which of the signed-in caller's own follows also follow `actor` (a handle, DID or bsky.app profile URL) — the 'Followed by' line on a profile.","description":"Which of the signed-in caller's own follows also follow `actor` (a handle, DID or bsky.app profile URL) — the 'Followed by' line on a profile. Needs the caller signed in to bsky.app — the run pauses for a sign-in link when they are not. THROWS `blueskyInputError` for an unknown actor, `blueskyError` when the saved sign-in has expired.\n\nCalls `bowmark.providers.bluesky.getKnownFollowers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<BlueskyKnownFollowers>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"anyOf":[{"type":"string"},{"type":"object","properties":{"actor":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"required":["actor"],"additionalProperties":true}],"description":"TypeScript: `string | { actor: string; limit?: number; cursor?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["actor"],"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}}},"BlueskyActorActionArgs":{"type":"object","properties":{"actor":{"type":"string"},"undo":{"type":"boolean"}},"required":["actor"],"additionalProperties":true},"BlueskyAddToListArgs":{"type":"object","properties":{"list":{"type":"string"},"actor":{"type":"string"},"undo":{"type":"boolean"}},"required":["list","actor"],"additionalProperties":true},"BlueskyBlockModerationListArgs":{"type":"object","properties":{"list":{"type":"string"},"undo":{"type":"boolean"}},"required":["list"],"additionalProperties":true},"BlueskyCreateListArgs":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"purpose":{"anyOf":[{"const":"curate"},{"const":"moderate"}]}},"required":["name"],"additionalProperties":true},"BlueskyCreatePostArgs":{"type":"object","properties":{"text":{"type":"string"},"langs":{"type":"array","items":{"type":"string"}}},"required":["text"],"additionalProperties":true},"BlueskyCreatePostWithImagesArgs":{"type":"object","properties":{"text":{"type":"string"},"images":{"type":"array","items":{"$ref":"#/components/schemas/BlueskyPostImage"}},"langs":{"type":"array","items":{"type":"string"}}},"required":["images"],"additionalProperties":true},"BlueskyDeleteListArgs":{"type":"object","properties":{"list":{"type":"string"}},"required":["list"],"additionalProperties":true},"BlueskyGetConversationArgs":{"type":"object","properties":{"conversationId":{"type":"string"},"with":{"type":"string"},"limit":{"type":"number"},"cursor":{"type":"string"}},"additionalProperties":true},"BlueskyLeaveConversationArgs":{"type":"object","properties":{"conversationId":{"type":"string"}},"required":["conversationId"],"additionalProperties":true},"BlueskyMuteConversationArgs":{"type":"object","properties":{"conversationId":{"type":"string"},"with":{"type":"string"},"undo":{"type":"boolean"}},"additionalProperties":true},"BlueskyMuteModerationListArgs":{"type":"object","properties":{"list":{"type":"string"},"undo":{"type":"boolean"}},"required":["list"],"additionalProperties":true},"BlueskyMuteThreadArgs":{"type":"object","properties":{"post":{"type":"string"},"undo":{"type":"boolean"}},"required":["post"],"additionalProperties":true},"BlueskyMuteWordArgs":{"type":"object","properties":{"word":{"type":"string"},"targets":{"type":"array","items":{"anyOf":[{"const":"content"},{"const":"tag"}]}},"excludeFollowing":{"type":"boolean"},"expiresAt":{"type":"string"},"undo":{"type":"boolean"}},"required":["word"],"additionalProperties":true},"BlueskyPostActionArgs":{"type":"object","properties":{"post":{"type":"string"},"undo":{"type":"boolean"}},"required":["post"],"additionalProperties":true},"BlueskyPostImage":{"type":"object","properties":{"image":{"type":"string"},"alt":{"type":"string"}},"required":["image"],"additionalProperties":true},"BlueskyQuotePostArgs":{"type":"object","properties":{"post":{"type":"string"},"text":{"type":"string"},"langs":{"type":"array","items":{"type":"string"}}},"required":["post","text"],"additionalProperties":true},"BlueskyReplyRule":{},"BlueskyReplyToPostArgs":{"type":"object","properties":{"post":{"type":"string"},"text":{"type":"string"},"langs":{"type":"array","items":{"type":"string"}}},"required":["post","text"],"additionalProperties":true},"BlueskySaveFeedArgs":{"type":"object","properties":{"feed":{"type":"string"},"pinned":{"type":"boolean"},"undo":{"type":"boolean"}},"required":["feed"],"additionalProperties":true},"BlueskySendMessageArgs":{"type":"object","properties":{"to":{"type":"string"},"conversationId":{"type":"string"},"text":{"type":"string"}},"required":["text"],"additionalProperties":true},"BlueskySetAvatarArgs":{"type":"object","properties":{"image":{"type":"string"},"banner":{"type":"boolean"}},"required":["image"],"additionalProperties":true},"BlueskySetReplyRestrictionArgs":{"type":"object","properties":{"post":{"type":"string"},"allow":{"anyOf":[{"const":"everyone"},{"const":"nobody"},{"type":"array","items":{"$ref":"#/components/schemas/BlueskyReplyRule"}}]}},"required":["post","allow"],"additionalProperties":true},"BlueskyUpdateProfileArgs":{"type":"object","properties":{"displayName":{"type":"string"},"bio":{"type":"string"}},"additionalProperties":true},"BlueskyVideoPostArgs":{"type":"object","properties":{"text":{"type":"string"},"video":{"type":"string"},"alt":{"type":"string"},"langs":{"type":"array","items":{"type":"string"}}},"required":["video"],"additionalProperties":true}}}}