{"openapi":"3.1.0","info":{"title":"Discord API (Bowmark)","version":"e833508f87ff","description":"Discord, chat for communities. Built so far: the public server directory (browse, search, categories, one server's page), invite lookup, and Discord's developer documentation (docs.discord.com, formerly discord.com/developers/docs) — list every page, then read one as clean markdown: REST endpoints, object tables, Gateway events, interactions, rate limits.\n\nEvery function Bowmark has for Discord (discord.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/discord/listDocPages":{"post":{"operationId":"listDocPages","summary":"Lists every Discord developer docs page — title, url and one-line description — from the site's own /llms.txt.","description":"Lists every Discord developer docs page — title, url and one-line description — from the site's own /llms.txt. Filter by title/description, then pass a url to getDocPage.\n\nCalls `bowmark.providers.discord.listDocPages`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordDocLink[]>`.","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/discord/getDocPage":{"post":{"operationId":"getDocPage","summary":"Reads one Discord developer docs page — `url` is a docs.discord.com or discord.com/developers/docs url, or a path like \"/developers/resources/channel\" — and returns its title, description and body as ","description":"Reads one Discord developer docs page — `url` is a docs.discord.com or discord.com/developers/docs url, or a path like \"/developers/resources/channel\" — and returns its title, description and body as markdown (endpoint routes, field tables). Throws discordInputError for a url outside the developer docs.\n\nCalls `bowmark.providers.discord.getDocPage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordDocPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"TypeScript: `string`"}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/discord/searchServers":{"post":{"operationId":"searchServers","summary":"Searches Discord's public server directory (discord.com/servers) by keyword, optionally inside one category (\"gaming\", \"music\", \"entertainment\", \"education\", \"science & tech\") — each server's id, name","description":"Searches Discord's public server directory (discord.com/servers) by keyword, optionally inside one category (\"gaming\", \"music\", \"entertainment\", \"education\", \"science & tech\") — each server's id, name, slug, description, badge, online and member counts, plus the directory's own total. Twelve a page; pass nextOffset back as `offset` for the next.\n\nCalls `bowmark.providers.discord.searchServers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordServerSearch>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"category":{"type":"string"},"offset":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ category?: string; offset?: 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/discord/listServerCategories":{"post":{"operationId":"listServerCategories","summary":"Lists the public server directory's categories (Gaming, Entertainment, Education, Music, Science & Tech) with how many servers each holds and the slug searchServers' `category` and listServers take.","description":"Lists the public server directory's categories (Gaming, Entertainment, Education, Music, Science & Tech) with how many servers each holds and the slug searchServers' `category` and listServers take.\n\nCalls `bowmark.providers.discord.listServerCategories`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordServerCategory[]>`.","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/discord/listServers":{"post":{"operationId":"listServers","summary":"Browses Discord's public server directory with no keyword — the directory's own featured order, all servers or one category — same rows as searchServers, twelve a page; pass nextOffset back as `offset","description":"Browses Discord's public server directory with no keyword — the directory's own featured order, all servers or one category — same rows as searchServers, twelve a page; pass nextOffset back as `offset`.\n\nCalls `bowmark.providers.discord.listServers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordServerSearch>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"category":{"type":"string"},"offset":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ category?: string; offset?: 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/discord/getServer":{"post":{"operationId":"getServer","summary":"Reads one server's public directory page (a slug-id from searchServers/listServers, a discord.com/servers/...","description":"Reads one server's public directory page (a slug-id from searchServers/listServers, a discord.com/servers/... url, or a bare server id) — name, description, About text, online and member counts, verified, categories, languages, established date, social links and icon.\n\nCalls `bowmark.providers.discord.getServer`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordServer>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slugOrId":{"type":"string","description":"TypeScript: `string`"}},"required":["slugOrId"],"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/discord/getInvite":{"post":{"operationId":"getInvite","summary":"Resolves a Discord invite (discord.gg/<code>, discord.com/invite/<code> or the bare code) to the server it opens — server id, name, description, feature flags, approximate member and online counts, an","description":"Resolves a Discord invite (discord.gg/<code>, discord.com/invite/<code> or the bare code) to the server it opens — server id, name, description, feature flags, approximate member and online counts, and when the invite expires.\n\nCalls `bowmark.providers.discord.getInvite`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordInvite>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"TypeScript: `string`"}},"required":["code"],"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/discord/listServerAnnouncements":{"post":{"operationId":"listServerAnnouncements","summary":"Lists the posts a server publishes to its public announcements page (discord.com/announcements/<serverId>) — each post's headline, url, publish date, reaction count and images, plus the server and cha","description":"Lists the posts a server publishes to its public announcements page (discord.com/announcements/<serverId>) — each post's headline, url, publish date, reaction count and images, plus the server and channel names. `serverId` is getServer()'s id or getInvite()'s guildId. Pass a row's url to getAnnouncement for the full text.\n\nCalls `bowmark.providers.discord.listServerAnnouncements`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordServerAnnouncements>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"serverId":{"type":"string","description":"TypeScript: `string`"}},"required":["serverId"],"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/discord/getAnnouncement":{"post":{"operationId":"getAnnouncement","summary":"Reads one public announcement post in full — headline, full body text, publish/edit dates, reaction count and images.","description":"Reads one public announcement post in full — headline, full body text, publish/edit dates, reaction count and images. Pass a row's `url` from listServerAnnouncements() as the one argument, or a (serverId, postId) pair.\n\nCalls `bowmark.providers.discord.getAnnouncement`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordAnnouncement>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"urlOrServerId":{"type":"string","description":"TypeScript: `string`"},"postId":{"type":"string","description":"TypeScript: `string`"}},"required":["urlOrServerId"],"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/discord/listTrendingGames":{"post":{"operationId":"listTrendingGames","summary":"Lists the games trending on Discord this week (discord.com/trending-games), overall or in one category — rank, name, cover image, this week's change in plays and streams, categories, and — when the di","description":"Lists the games trending on Discord this week (discord.com/trending-games), overall or in one category — rank, name, cover image, this week's change in plays and streams, categories, and — when the directory links one — the official server's name, member/online counts and join url. Pass a row's slug-id to getGame.\n\nCalls `bowmark.providers.discord.listTrendingGames`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordTrendingGame[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","description":"TypeScript: `string`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/discord/getGame":{"post":{"operationId":"getGame","summary":"Reads one game's page on Discord (discord.com/game/<slug>-<id>) — name, description, genres, platforms, publishers, rating and the official server it links to (as getServer's slug-id).","description":"Reads one game's page on Discord (discord.com/game/<slug>-<id>) — name, description, genres, platforms, publishers, rating and the official server it links to (as getServer's slug-id). `slug` is a row's slug from listTrendingGames(), e.g. \"peak-1384276457596911676\".\n\nCalls `bowmark.providers.discord.getGame`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordGame>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string","description":"TypeScript: `string`"}},"required":["slug"],"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/discord/listBlogPosts":{"post":{"operationId":"listBlogPosts","summary":"Lists Discord's own blog posts (discord.com/blog) — title, url, publish date, summary and thumbnail, newest first.","description":"Lists Discord's own blog posts (discord.com/blog) — title, url, publish date, summary and thumbnail, newest first.\n\nCalls `bowmark.providers.discord.listBlogPosts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordBlogPost[]>`.","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/discord/searchApps":{"post":{"operationId":"searchApps","summary":"Searches Discord's App Directory (bots, games and activities) by keyword — each app's id, name, description, icon, verified/monetized flags, tags, categories and approximate server count.","description":"Searches Discord's App Directory (bots, games and activities) by keyword — each app's id, name, description, icon, verified/monetized flags, tags, categories and approximate server count. Pass a row's id to getApp for the full listing.\n\nCalls `bowmark.providers.discord.searchApps`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordAppSearch>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/discord/getApp":{"post":{"operationId":"getApp","summary":"Reads one App Directory listing in full — everything searchApps returns, plus the longer write-up, terms-of-service and privacy-policy links, external links, and the documented OAuth2 install url.","description":"Reads one App Directory listing in full — everything searchApps returns, plus the longer write-up, terms-of-service and privacy-policy links, external links, and the documented OAuth2 install url. `id` is a row's id from searchApps().\n\nCalls `bowmark.providers.discord.getApp`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordApp>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"TypeScript: `string`"}},"required":["id"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/discord/listAppCategories":{"post":{"operationId":"listAppCategories","summary":"Lists the App Directory's categories (Games, Entertainment, Moderation and Tools, Social, Utilities) with the ids searchApps' row-level `categories` and the directory's own category filter use.","description":"Lists the App Directory's categories (Games, Entertainment, Moderation and Tools, Social, Utilities) with the ids searchApps' row-level `categories` and the directory's own category filter use.\n\nCalls `bowmark.providers.discord.listAppCategories`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordAppCategory[]>`.","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/discord/listFeaturedApps":{"post":{"operationId":"listFeaturedApps","summary":"Lists the App Directory's featured collections (\"Action Games\" and the rest) — each with its title, description and the full apps in it (the same shape getApp returns).","description":"Lists the App Directory's featured collections (\"Action Games\" and the rest) — each with its title, description and the full apps in it (the same shape getApp returns).\n\nCalls `bowmark.providers.discord.listFeaturedApps`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordAppCollection[]>`.","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/discord/listSimilarApps":{"post":{"operationId":"listSimilarApps","summary":"Lists the apps the App Directory shows as similar to one app — the same full shape getApp returns.","description":"Lists the apps the App Directory shows as similar to one app — the same full shape getApp returns. `id` is a row's id from searchApps() or getApp(). Returns an empty array when the directory has no similar apps for it.\n\nCalls `bowmark.providers.discord.listSimilarApps`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordApp[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"TypeScript: `string`"}},"required":["id"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/discord/getMyProfile":{"post":{"operationId":"getMyProfile","summary":"Reads the SIGNED-IN user's own Discord account — id, username, display name, avatar url, bio, pronouns, email-verified flag, Nitro tier and locale.","description":"Reads the SIGNED-IN user's own Discord account — id, username, display name, avatar url, bio, pronouns, email-verified flag, Nitro tier and locale. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.getMyProfile`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordMyProfile>`.","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/discord/listMyServers":{"post":{"operationId":"listMyServers","summary":"Lists the servers the SIGNED-IN user has joined — id, name, icon url, whether they own it, their permission bitfield, and approximate member and online counts.","description":"Lists the servers the SIGNED-IN user has joined — id, name, icon url, whether they own it, their permission bitfield, and approximate member and online counts. A row's `id` is the server id other session functions take. An account in no servers returns `[]`. Needs a Discord sign-in made through Bowmark's sign-in link.\n\nCalls `bowmark.providers.discord.listMyServers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordMyServer[]>`.","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/discord/listMessages":{"post":{"operationId":"listMessages","summary":"Reads a channel's most recent messages AS THE SIGNED-IN USER, newest first — author, text, attachment urls, embed count, reactions, the message it replies to, and timestamps.","description":"Reads a channel's most recent messages AS THE SIGNED-IN USER, newest first — author, text, attachment urls, embed count, reactions, the message it replies to, and timestamps. `channelId` is the last number in a discord.com/channels/<server>/<channel> url; `limit` is 1-100 (default 50). An empty channel returns `messages: []`. Throws when the account is not a member of that channel or cannot read it. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.listMessages`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordChannelMessages>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"channelId":{"type":"string"},"limit":{"type":"number"}},"required":["channelId"],"additionalProperties":true,"description":"TypeScript: `{ channelId: string; limit?: number }`"},"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/discord/listChannels":{"post":{"operationId":"listChannels","summary":"Lists one joined server's channels AS THE SIGNED-IN USER — id, name, type (text, voice, announcement, stage, forum), topic and the category it sits under.","description":"Lists one joined server's channels AS THE SIGNED-IN USER — id, name, type (text, voice, announcement, stage, forum), topic and the category it sits under. `guildId` is a row's id from listMyServers(). Pass a row's id to listMessages. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.listChannels`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordChannel[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"guildId":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["guildId"],"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/discord/listDirectMessages":{"post":{"operationId":"listDirectMessages","summary":"Lists the SIGNED-IN USER's DM and group-DM conversations, most recently active first — the channel id, the other people in it, a group's name and the last message id.","description":"Lists the SIGNED-IN USER's DM and group-DM conversations, most recently active first — the channel id, the other people in it, a group's name and the last message id. Pass a row's id to listMessages or searchMessages({ channelId }). Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.listDirectMessages`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordDirectMessage[]>`.","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/discord/listFriends":{"post":{"operationId":"listFriends","summary":"Lists the SIGNED-IN USER's Discord friends — user id, username, display name, the caller's nickname for them, avatar and since when.","description":"Lists the SIGNED-IN USER's Discord friends — user id, username, display name, the caller's nickname for them, avatar and since when. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.listFriends`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordFriend[]>`.","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/discord/listFriendRequests":{"post":{"operationId":"listFriendRequests","summary":"Lists the SIGNED-IN USER's pending friend requests, each marked `incoming` or `outgoing`, with the other user's id, username, display name and avatar.","description":"Lists the SIGNED-IN USER's pending friend requests, each marked `incoming` or `outgoing`, with the other user's id, username, display name and avatar. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.listFriendRequests`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordFriendRequest[]>`.","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/discord/getUserProfile":{"post":{"operationId":"getUserProfile","summary":"Reads another Discord user's profile AS THE SIGNED-IN USER — username, display name, avatar, banner, bio, pronouns, badges, and the servers and friends the caller shares with them.","description":"Reads another Discord user's profile AS THE SIGNED-IN USER — username, display name, avatar, banner, bio, pronouns, badges, and the servers and friends the caller shares with them. `userId` comes off a message author, a friend or a DM recipient. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.getUserProfile`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordUserProfile>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"],"additionalProperties":true,"description":"TypeScript: `{ userId: string }`"},"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/discord/listMentions":{"post":{"operationId":"listMentions","summary":"Lists recent messages that mentioned the SIGNED-IN USER (directly, by role or @everyone) — the Inbox's Mentions tab, newest first, each with its server id.","description":"Lists recent messages that mentioned the SIGNED-IN USER (directly, by role or @everyone) — the Inbox's Mentions tab, newest first, each with its server id. `limit` 1-100 (default 25); `guildId` narrows to one server. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.listMentions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordMention[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"limit":{"type":"number"},"guildId":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number; guildId?: string }`"},"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/discord/listPinnedMessages":{"post":{"operationId":"listPinnedMessages","summary":"Lists the messages pinned in one channel or DM the SIGNED-IN USER can read, with when each was pinned.","description":"Lists the messages pinned in one channel or DM the SIGNED-IN USER can read, with when each was pinned. `channelId` from listChannels() or listDirectMessages(). Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.listPinnedMessages`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordPinnedMessage[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"channelId":{"type":"string"}},"required":["channelId"],"additionalProperties":true,"description":"TypeScript: `{ channelId: string }`"},"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/discord/listThreads":{"post":{"operationId":"listThreads","summary":"Lists the threads in a text channel, or the posts in a forum channel, AS THE SIGNED-IN USER — name, starter, message count, tags — most recently active first, 25 a page.","description":"Lists the threads in a text channel, or the posts in a forum channel, AS THE SIGNED-IN USER — name, starter, message count, tags — most recently active first, 25 a page. `archived: true` lists archived ones instead. Pass a thread's id to listMessages. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.listThreads`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordThreadList>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"channelId":{"type":"string"},"archived":{"type":"boolean"},"offset":{"type":"number"}},"required":["channelId"],"additionalProperties":true,"description":"TypeScript: `{ channelId: string; archived?: boolean; offset?: number }`"},"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/discord/searchServerMembers":{"post":{"operationId":"searchServerMembers","summary":"Finds members of a server the SIGNED-IN USER has joined whose username or nickname starts with `query` — id, username, display name, server nickname, avatar, role ids, join date.","description":"Finds members of a server the SIGNED-IN USER has joined whose username or nickname starts with `query` — id, username, display name, server nickname, avatar, role ids, join date. `guildId` from listMyServers(); `limit` 1-1000 (default 25). Pass a member's id to getUserProfile. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.searchServerMembers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordServerMember[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"guildId":{"type":"string"},"query":{"type":"string"},"limit":{"type":"number"}},"required":["guildId","query"],"additionalProperties":true,"description":"TypeScript: `{ guildId: string; query: string; limit?: number }`"},"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/discord/listServerEvents":{"post":{"operationId":"listServerEvents","summary":"Lists a joined server's scheduled events AS THE SIGNED-IN USER, soonest first — name, description, start and end, status, whether it is in a stage or voice channel or external (with its location), and","description":"Lists a joined server's scheduled events AS THE SIGNED-IN USER, soonest first — name, description, start and end, status, whether it is in a stage or voice channel or external (with its location), and how many are interested. `guildId` from listMyServers(). Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.listServerEvents`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordServerEvent[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"guildId":{"type":"string"}},"required":["guildId"],"additionalProperties":true,"description":"TypeScript: `{ guildId: string }`"},"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/discord/sendMessage":{"post":{"operationId":"sendMessage","summary":"Posts a message AS THE SIGNED-IN USER to a server channel or DM (`channelId` from listChannels() or listDirectMessages()), optionally as a reply to `replyToMessageId`.","description":"Posts a message AS THE SIGNED-IN USER to a server channel or DM (`channelId` from listChannels() or listDirectMessages()), optionally as a reply to `replyToMessageId`. `content` is 1-2000 characters. Returns the posted message. Sending the same text to the same channel twice in one run posts it once. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.sendMessage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordMessage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"channelId":{"type":"string"},"content":{"type":"string"},"replyToMessageId":{"type":"string"}},"required":["channelId","content"],"additionalProperties":true,"description":"TypeScript: `{ channelId: string; content: string; replyToMessageId?: string }`"},"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/discord/sendDirectMessage":{"post":{"operationId":"sendDirectMessage","summary":"Sends a direct message AS THE SIGNED-IN USER to one user by id (`userId` from listFriends(), searchServerMembers() or a message's author), opening the DM if none exists yet.","description":"Sends a direct message AS THE SIGNED-IN USER to one user by id (`userId` from listFriends(), searchServerMembers() or a message's author), opening the DM if none exists yet. `content` is 1-2000 characters. Returns the posted message; its channelId is the DM to pass to listMessages. Sending the same text to the same user twice in one run sends it once. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.sendDirectMessage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordMessage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"userId":{"type":"string"},"content":{"type":"string"}},"required":["userId","content"],"additionalProperties":true,"description":"TypeScript: `{ userId: string; content: string }`"},"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/discord/addReaction":{"post":{"operationId":"addReaction","summary":"Adds the SIGNED-IN USER's emoji reaction to a message.","description":"Adds the SIGNED-IN USER's emoji reaction to a message. `emoji` is a unicode emoji (\"👍\") or a custom server emoji as \"name:id\". `channelId` and `messageId` from listMessages(). Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.addReaction`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordReactionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"channelId":{"type":"string"},"messageId":{"type":"string"},"emoji":{"type":"string"}},"required":["channelId","messageId","emoji"],"additionalProperties":true,"description":"TypeScript: `{ channelId: string; messageId: string; emoji: string }`"},"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/discord/removeReaction":{"post":{"operationId":"removeReaction","summary":"Removes the SIGNED-IN USER's own emoji reaction from a message — same arguments as addReaction.","description":"Removes the SIGNED-IN USER's own emoji reaction from a message — same arguments as addReaction. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.removeReaction`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordReactionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"channelId":{"type":"string"},"messageId":{"type":"string"},"emoji":{"type":"string"}},"required":["channelId","messageId","emoji"],"additionalProperties":true,"description":"TypeScript: `{ channelId: string; messageId: string; emoji: string }`"},"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/discord/editMessage":{"post":{"operationId":"editMessage","summary":"Replaces the text of a message the SIGNED-IN USER sent (`channelId` and `messageId` from listMessages() or sendMessage()).","description":"Replaces the text of a message the SIGNED-IN USER sent (`channelId` and `messageId` from listMessages() or sendMessage()). `content` is 1-2000 characters. Returns the edited message. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.editMessage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordMessage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"channelId":{"type":"string"},"messageId":{"type":"string"},"content":{"type":"string"}},"required":["channelId","messageId","content"],"additionalProperties":true,"description":"TypeScript: `{ channelId: string; messageId: string; content: string }`"},"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/discord/deleteMessage":{"post":{"operationId":"deleteMessage","summary":"Deletes a message AS THE SIGNED-IN USER — their own, or anyone's in a server where they can manage messages (`channelId` and `messageId` from listMessages()).","description":"Deletes a message AS THE SIGNED-IN USER — their own, or anyone's in a server where they can manage messages (`channelId` and `messageId` from listMessages()). Cannot be undone. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.deleteMessage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordDeleteResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"channelId":{"type":"string"},"messageId":{"type":"string"}},"required":["channelId","messageId"],"additionalProperties":true,"description":"TypeScript: `{ channelId: string; messageId: string }`"},"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/discord/joinServer":{"post":{"operationId":"joinServer","summary":"Joins a server AS THE SIGNED-IN USER from an invite code or link (`invite`: \"N8AWaBP6\" or discord.gg/N8AWaBP6).","description":"Joins a server AS THE SIGNED-IN USER from an invite code or link (`invite`: \"N8AWaBP6\" or discord.gg/N8AWaBP6). Returns the server id and name and the channel the invite lands on. Discord sometimes demands an hCaptcha for a join; that comes back as an error saying so. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.joinServer`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordJoinResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"invite":{"type":"string"}},"required":["invite"],"additionalProperties":true,"description":"TypeScript: `{ invite: string }`"},"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/discord/leaveServer":{"post":{"operationId":"leaveServer","summary":"Leaves a server the SIGNED-IN USER is in (`guildId` from listServers() or joinServer()).","description":"Leaves a server the SIGNED-IN USER is in (`guildId` from listServers() or joinServer()). An owner cannot leave their own server. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.leaveServer`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordLeaveResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"guildId":{"type":"string"}},"required":["guildId"],"additionalProperties":true,"description":"TypeScript: `{ guildId: string }`"},"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/discord/createServer":{"post":{"operationId":"createServer","summary":"Creates a new server owned by the SIGNED-IN USER.","description":"Creates a new server owned by the SIGNED-IN USER. `name` is 2-100 characters; `icon` is an optional image as a data: URI. Returns the server id and its first text channel (systemChannelId). Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.createServer`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordCreatedServer>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"name":{"type":"string"},"icon":{"type":"string"}},"required":["name"],"additionalProperties":true,"description":"TypeScript: `{ name: string; icon?: string }`"},"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/discord/createInvite":{"post":{"operationId":"createInvite","summary":"Creates an invite link to a channel AS THE SIGNED-IN USER (`channelId` from listChannels()).","description":"Creates an invite link to a channel AS THE SIGNED-IN USER (`channelId` from listChannels()). `expiresInSeconds` 0-604800 (default 7 days, 0 = never expires), `useLimit` 0-100 (default 0 = unlimited). Returns the code and its discord.gg url. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.createInvite`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordCreatedInvite>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"channelId":{"type":"string"},"expiresInSeconds":{"type":"number"},"useLimit":{"type":"number"}},"required":["channelId"],"additionalProperties":true,"description":"TypeScript: `{ channelId: string; expiresInSeconds?: number; useLimit?: number }`"},"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/discord/sendFriendRequest":{"post":{"operationId":"sendFriendRequest","summary":"Sends a friend request AS THE SIGNED-IN USER, by `username` (the new unique handle) or `userId` (from getUserProfile()).","description":"Sends a friend request AS THE SIGNED-IN USER, by `username` (the new unique handle) or `userId` (from getUserProfile()). Discord may ask for a captcha on a new account. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.sendFriendRequest`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordRelationshipResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"username":{"type":"string"},"userId":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ username?: string; userId?: string }`"},"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/discord/acceptFriendRequest":{"post":{"operationId":"acceptFriendRequest","summary":"Accepts an incoming friend request from `userId` (see listFriendRequests()).","description":"Accepts an incoming friend request from `userId` (see listFriendRequests()). Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.acceptFriendRequest`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordRelationshipResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"],"additionalProperties":true,"description":"TypeScript: `{ userId: string }`"},"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/discord/removeFriend":{"post":{"operationId":"removeFriend","summary":"Removes a friend, or cancels / declines a pending request, for `userId` (see listFriends(), listFriendRequests()).","description":"Removes a friend, or cancels / declines a pending request, for `userId` (see listFriends(), listFriendRequests()). Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.removeFriend`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordRelationshipResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"],"additionalProperties":true,"description":"TypeScript: `{ userId: string }`"},"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/discord/blockUser":{"post":{"operationId":"blockUser","summary":"Blocks `userId` for the signed-in user; this also ends any friendship.","description":"Blocks `userId` for the signed-in user; this also ends any friendship. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.blockUser`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordRelationshipResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"],"additionalProperties":true,"description":"TypeScript: `{ userId: string }`"},"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/discord/updateProfile":{"post":{"operationId":"updateProfile","summary":"Changes the SIGNED-IN USER's display name (1-32), bio / About Me (up to 190) or pronouns (up to 40); pass only what should change, \"\" clears one.","description":"Changes the SIGNED-IN USER's display name (1-32), bio / About Me (up to 190) or pronouns (up to 40); pass only what should change, \"\" clears one. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.updateProfile`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordProfileResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"displayName":{"type":"string"},"bio":{"type":"string"},"pronouns":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ displayName?: string; bio?: string; pronouns?: string }`"},"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/discord/setAvatar":{"post":{"operationId":"setAvatar","summary":"Changes the SIGNED-IN USER's profile picture; `image` is a data: URI (\"data:image/png;base64,…\"), or null to remove it.","description":"Changes the SIGNED-IN USER's profile picture; `image` is a data: URI (\"data:image/png;base64,…\"), or null to remove it. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.setAvatar`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordAvatarResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"image":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["image"],"additionalProperties":true,"description":"TypeScript: `{ image: string | null }`"},"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/discord/setStatus":{"post":{"operationId":"setStatus","summary":"Sets the SIGNED-IN USER's presence and/or custom status text (up to 128 characters, null clears).","description":"Sets the SIGNED-IN USER's presence and/or custom status text (up to 128 characters, null clears). Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.setStatus`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordStatusResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"status":{"anyOf":[{"const":"online"},{"const":"idle"},{"const":"dnd"},{"const":"invisible"}]},"text":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":true,"description":"TypeScript: `{ status?: 'online' | 'idle' | 'dnd' | 'invisible'; text?: string | null }`"},"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/discord/createThread":{"post":{"operationId":"createThread","summary":"Starts a thread AS THE SIGNED-IN USER: off one message with `messageId`, as a new forum post with `content` (its first message, optional forum `tagIds`), or as an empty thread in a text channel with n","description":"Starts a thread AS THE SIGNED-IN USER: off one message with `messageId`, as a new forum post with `content` (its first message, optional forum `tagIds`), or as an empty thread in a text channel with neither. `name` is 1-100 characters. Returns the thread; its id is the channelId to pass to sendMessage or listMessages. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.createThread`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordThread>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"channelId":{"type":"string"},"name":{"type":"string"},"messageId":{"type":"string"},"content":{"type":"string"},"tagIds":{"type":"array","items":{"type":"string"}}},"required":["channelId","name"],"additionalProperties":true,"description":"TypeScript: `{ channelId: string; name: string; messageId?: string; content?: string; tagIds?: string[] }`"},"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/discord/listQuests":{"post":{"operationId":"listQuests","summary":"Lists the Quests Discord currently offers the SIGNED-IN USER — quest and game name, the task (e.g.","description":"Lists the Quests Discord currently offers the SIGNED-IN USER — quest and game name, the task (e.g. play for 15 minutes), rewards, expiry, and the caller's enrolment, completion and progress. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.listQuests`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordQuest[]>`.","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/discord/searchMessages":{"post":{"operationId":"searchMessages","summary":"Searches messages AS THE SIGNED-IN USER with Discord's own search — in one joined server (`guildId` from listMyServers(), optionally narrowed with `channelId`) or one DM (`channelId` alone).","description":"Searches messages AS THE SIGNED-IN USER with Discord's own search — in one joined server (`guildId` from listMyServers(), optionally narrowed with `channelId`) or one DM (`channelId` alone). Give at least one of `query` (text), `authorId` or `has`. Returns 25 hits a page with Discord's total hit count; step `offset` by 25 for more. Throws a retry message while Discord is still indexing a server. Needs a Discord sign-in made through Bowmark's sign-in link: Bowmark Buddy cannot pass Discord's token from your own browser yet.\n\nCalls `bowmark.providers.discord.searchMessages`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<discordMessageSearch>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"type":"object","properties":{"guildId":{"type":"string"},"channelId":{"type":"string"},"query":{"type":"string"},"authorId":{"type":"string"},"has":{"anyOf":[{"const":"link"},{"const":"embed"},{"const":"file"},{"const":"image"},{"const":"video"},{"const":"sound"},{"const":"sticker"},{"const":"poll"}]},"offset":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ guildId?: string; channelId?: string; query?: string; authorId?: string; has?: \"link\" | \"embed\" | \"file\" | \"image\" | \"video\" | \"sound\" | \"sticker\" | \"poll\"; offset?: number }`"},"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"}}}}}}}},"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}}}}}}