{"openapi":"3.1.0","info":{"title":"GitHub API (Bowmark)","version":"e833508f87ff","description":"GitHub's own REST API, keyless. Built: a public repo's commit log (sha, author, date, message), paged and windowed; a public repo's release history (tag, name, dates, release notes text), paged; a public repo's metadata (name, description, stars, forks, language, license, homepage); a user's public profile information; every public repo a user owns, sorted and paged; a repository search across all of GitHub by name, language, topic, stars and other qualifiers.\n\nEvery function Bowmark has for GitHub (github.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/github/listWorkflowRuns":{"post":{"operationId":"listWorkflowRuns","summary":"Lists a public repo's GitHub Actions workflow runs, newest first — answers \"is CI green on main / on my branch?\".","description":"Lists a public repo's GitHub Actions workflow runs, newest first — answers \"is CI green on main / on my branch?\". Each run's workflow name, title, run number, branch, head sha, triggering event, status (queued/in_progress/completed) and conclusion (success/failure/cancelled/…, null until completed), dates and URL. `options.branch`, `options.event` (push, pull_request, …) and `options.status` (a status or a conclusion) filter; `per_page` (1-100) and `page` page. Keyless REST, shares the 60 requests/hour per IP ceiling. THROWS on an unknown owner/repo (404) or a rate limit.\n\nCalls `bowmark.providers.github.listWorkflowRuns`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListWorkflowRunsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubListWorkflowRunsOptions","description":"TypeScript: `GithubListWorkflowRunsOptions`"}},"required":["owner","repo"],"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/github/compareCommits":{"post":{"operationId":"compareCommits","summary":"Compares two refs (tags, branches or commit shas) of a public repo — answers \"what changed between v1.7.0 and v1.7.2?\".","description":"Compares two refs (tags, branches or commit shas) of a public repo — answers \"what changed between v1.7.0 and v1.7.2?\". Returns ahead/behind counts, the commits in head not in base (sha, author, date, message, URL) and every changed file with its status, additions, deletions and diff patch. GitHub caps a comparison at 250 commits and 300 files; `warnings` says when either cap cut the answer. Keyless REST, shares the 60 requests/hour per IP ceiling. THROWS on an unknown repo or ref (404) or a rate limit.\n\nCalls `bowmark.providers.github.compareCommits`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubCompareResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"base":{"type":"string","description":"TypeScript: `string`"},"head":{"type":"string","description":"TypeScript: `string`"}},"required":["owner","repo","base","head"],"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/github/listSecurityAdvisories":{"post":{"operationId":"listSecurityAdvisories","summary":"Lists known security vulnerabilities — answers \"does this package have known vulnerabilities?\".","description":"Lists known security vulnerabilities — answers \"does this package have known vulnerabilities?\". Pass `{ ecosystem: 'npm', package: 'axios' }` (or `package: 'axios@1.6.0'` to keep only those affecting that version) to search GitHub's global advisory database, or `{ owner, repo }` for a repository's own published advisories. Each advisory's GHSA id, CVE id, severity, summary, description, affected packages with vulnerable and patched version ranges, published date and URL. `severity` (low/medium/high/critical) filters. Keyless REST, shares the 60 requests/hour per IP ceiling. A package with no advisories returns `advisories: []`.\n\nCalls `bowmark.providers.github.listSecurityAdvisories`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListSecurityAdvisoriesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"$ref":"#/components/schemas/GithubListSecurityAdvisoriesOptions","description":"TypeScript: `GithubListSecurityAdvisoriesOptions`"}},"required":["options"],"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/github/listCommits":{"post":{"operationId":"listCommits","summary":"Returns a public repo's commit log off GitHub's own unauthenticated REST commits endpoint — each commit's sha, author name/email, author date, message and its own github.com URL.","description":"Returns a public repo's commit log off GitHub's own unauthenticated REST commits endpoint — each commit's sha, author name/email, author date, message and its own github.com URL. `options.sha` starts from a branch/tag/commit other than the default branch; `options.since`/`until` (ISO 8601) window by date; `options.author` (a login or an email) keeps only that author's commits; `options.per_page` (GitHub's own 1-100 ceiling, default 30) and `options.page` page through history. Unauthenticated calls are capped at 60 requests/hour per IP — GitHub's own published ceiling, not something this provider adds. THROWS on an unknown owner/repo (404) or a rate limit (403/429); a repo with no commits yet (409, GitHub's own empty-history response) returns `commits: []`, not a throw.\n\nCalls `bowmark.providers.github.listCommits`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListCommitsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubListCommitsOptions","description":"TypeScript: `GithubListCommitsOptions`"}},"required":["owner","repo"],"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/github/listReleases":{"post":{"operationId":"listReleases","summary":"Returns a public repo's release history off GitHub's own unauthenticated REST releases endpoint — each release's tag, name, draft/prerelease flags, created/published dates, its release notes text (`no","description":"Returns a public repo's release history off GitHub's own unauthenticated REST releases endpoint — each release's tag, name, draft/prerelease flags, created/published dates, its release notes text (`notes`) and its own github.com URL. This is a project's own release notes documentation — `listReleases(\"microsoft\", \"TypeScript\")` returns the TypeScript compiler's. `options.per_page` (GitHub's own 1-100 ceiling, default 30) and `options.page` page through history, newest first (GitHub's own ordering). Unauthenticated calls are capped at 60 requests/hour per IP, the same shared ceiling `listCommits` spends against. THROWS on an unknown owner/repo (404) or a rate limit (403/429); a repo with no releases yet returns `releases: []`, not a throw.\n\nCalls `bowmark.providers.github.listReleases`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListReleasesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubListReleasesOptions","description":"TypeScript: `GithubListReleasesOptions`"}},"required":["owner","repo"],"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/github/listContributors":{"post":{"operationId":"listContributors","summary":"Lists who has contributed to a public repository, most commits first — each contributor's login, account type (User/Bot), contribution count, avatar and profile URL.","description":"Lists who has contributed to a public repository, most commits first — each contributor's login, account type (User/Bot), contribution count, avatar and profile URL. Off GitHub's own unauthenticated REST contributors endpoint. `options.per_page` (1-100, default 30) and `options.page` page through. Shares the 60 requests/hour per IP ceiling. THROWS on an unknown owner/repo (404) or a rate limit (403/429); an empty repo returns `contributors: []`.\n\nCalls `bowmark.providers.github.listContributors`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListContributorsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubListContributorsOptions","description":"TypeScript: `GithubListContributorsOptions`"}},"required":["owner","repo"],"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/github/getFileContents":{"post":{"operationId":"getFileContents","summary":"Reads any file in a public repository, decoded to text — `package.json`, `LICENSE`, a docs page — or lists a directory (`kind: \"directory\"`, with `entries`; pass `\"\"` for the repo root).","description":"Reads any file in a public repository, decoded to text — `package.json`, `LICENSE`, a docs page — or lists a directory (`kind: \"directory\"`, with `entries`; pass `\"\"` for the repo root). `options.ref` reads a branch, tag or commit other than the default branch. Off GitHub's own unauthenticated REST contents endpoint; shares the 60 requests/hour per IP ceiling. A file over 1 MB comes back with `content: null` — use `downloadUrl`. THROWS on a path, ref or repo that does not exist (404) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.getFileContents`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubFileContents>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"path":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubGetFileContentsOptions","description":"TypeScript: `GithubGetFileContentsOptions`"}},"required":["owner","repo","path"],"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/github/listIssueComments":{"post":{"operationId":"listIssueComments","summary":"Reads the comment thread on an issue or pull request, oldest first — each comment's author, body, dates, the author's association with the repo (OWNER/MEMBER/CONTRIBUTOR/NONE) and URL.","description":"Reads the comment thread on an issue or pull request, oldest first — each comment's author, body, dates, the author's association with the repo (OWNER/MEMBER/CONTRIBUTOR/NONE) and URL. `getIssue` gives only the count; this is the conversation. `options.since` (ISO 8601) keeps only comments updated after it; `options.per_page` (1-100, default 30) and `options.page` page through. Shares the 60 requests/hour per IP ceiling. THROWS on an unknown issue or repo (404) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.listIssueComments`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListIssueCommentsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"issueNumber":{"type":"number","description":"TypeScript: `number`"},"options":{"$ref":"#/components/schemas/GithubListIssueCommentsOptions","description":"TypeScript: `GithubListIssueCommentsOptions`"}},"required":["owner","repo","issueNumber"],"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/github/listPullRequestFiles":{"post":{"operationId":"listPullRequestFiles","summary":"Lists what a pull request changes — each file's name, status (added/modified/removed/renamed), additions, deletions and its unified diff (`patch`, null for binary or huge files).","description":"Lists what a pull request changes — each file's name, status (added/modified/removed/renamed), additions, deletions and its unified diff (`patch`, null for binary or huge files). `options.per_page` (1-100, default 30) and `options.page` page through; GitHub caps the list at 3,000 files. Shares the 60 requests/hour per IP ceiling. THROWS on an unknown pull request or repo (404) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.listPullRequestFiles`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListPullRequestFilesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"pullNumber":{"type":"number","description":"TypeScript: `number`"},"options":{"$ref":"#/components/schemas/GithubListPullRequestFilesOptions","description":"TypeScript: `GithubListPullRequestFilesOptions`"}},"required":["owner","repo","pullNumber"],"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/github/searchIssues":{"post":{"operationId":"searchIssues","summary":"Free-text search over issues and pull requests across GitHub — \"has anyone reported X?\".","description":"Free-text search over issues and pull requests across GitHub — \"has anyone reported X?\". `query` is GitHub's own search syntax, e.g. `\"repo:microsoft/vscode is:issue is:open terminal crash\"`; add `is:issue` or `is:pr` to narrow. Returns `totalCount` and each hit's number, title, state, whether it is a PR, author, labels, comment count, dates, repository (`owner/name`) and URL. `options.sort` (`comments`/`reactions`/`created`/`updated`, default relevance), `options.order`, `options.per_page` (1-100) and `options.page`. Uses the stricter search ceiling: 10 requests/minute per IP. THROWS on an invalid query (422) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.searchIssues`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubSearchIssuesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubSearchIssuesOptions","description":"TypeScript: `GithubSearchIssuesOptions`"}},"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/github/getReadme":{"post":{"operationId":"getReadme","summary":"Returns a public repository's README, decoded to text, whatever its filename (README.md, README.rst, readme.txt…) — plus its path, size and github.com URL.","description":"Returns a public repository's README, decoded to text, whatever its filename (README.md, README.rst, readme.txt…) — plus its path, size and github.com URL. Off GitHub's own unauthenticated REST readme endpoint. Shares the 60 requests/hour per IP ceiling. THROWS on a repo with no README or an unknown owner/repo (404), or a rate limit (403/429).\n\nCalls `bowmark.providers.github.getReadme`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubReadme>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"}},"required":["owner","repo"],"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/github/getRepo":{"post":{"operationId":"getRepo","summary":"Returns a public repository's own metadata — its full name, description, default branch, star/fork/open-issue counts, primary language, license (if declared), homepage URL (if declared), and creation/","description":"Returns a public repository's own metadata — its full name, description, default branch, star/fork/open-issue counts, primary language, license (if declared), homepage URL (if declared), and creation/update timestamps. Off GitHub's own documented unauthenticated REST repos endpoint. Takes an owner and repo name, or a github.com URL. THROWS on an unknown owner/repo (404) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.getRepo`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubRepository>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"}},"required":["owner","repo"],"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/github/getProfileReadme":{"post":{"operationId":"getProfileReadme","summary":"Reads a person's own GitHub profile — display name, company, the website they list, bio, X handle — and the raw markdown of their profile README (the `<handle>/<handle>` repo GitHub shows on the profi","description":"Reads a person's own GitHub profile — display name, company, the website they list, bio, X handle — and the raw markdown of their profile README (the `<handle>/<handle>` repo GitHub shows on the profile page), which is where people put a personal site, a booking link or contact details. Takes a username, `@handle` or github.com url. `readme` is null when they have no profile README. Unauthenticated calls share GitHub's 60 requests/hour per IP; this spends two. THROWS on an unknown user or a rate limit.\n\nCalls `bowmark.providers.github.getProfileReadme`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubProfileReadme>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"TypeScript: `string`"}},"required":["handle"],"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/github/searchRepositories":{"post":{"operationId":"searchRepositories","summary":"Runs a repository search across all of GitHub off GitHub's own unauthenticated REST search endpoint.","description":"Runs a repository search across all of GitHub off GitHub's own unauthenticated REST search endpoint. `query` is GitHub's own search-qualifier syntax — the same thing typed into github.com's search bar — e.g. `\"stars:>50000 language:typescript\"`, `\"topic:cli\"`, `\"org:vercel\"`. Returns `totalCount` (GitHub's own match count, which may exceed the page) and each matching repo's full name, owner, description, star/fork counts, primary language, URL and last-updated date. `options.sort` (`stars`/`forks`/`help-wanted-issues`/`updated`, default best-match relevance) and `options.order` (`asc`/`desc`) control ranking; `options.per_page` (1-100, default 30) and `options.page` page through results — GitHub caps deep paging at 1,000 total results for any query. The search endpoints share a STRICTER unauthenticated ceiling than every other function here: 10 requests/minute per IP, not the 60/hour core-API bucket. THROWS on an invalid query (422) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.searchRepositories`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubSearchRepositoriesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubSearchRepositoriesOptions","description":"TypeScript: `GithubSearchRepositoriesOptions`"}},"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/github/getUserRepositories":{"post":{"operationId":"getUserRepositories","summary":"Lists every PUBLIC repository a user owns, off GitHub's own unauthenticated REST endpoint.","description":"Lists every PUBLIC repository a user owns, off GitHub's own unauthenticated REST endpoint. Each row carries the repo's name, description, fork/archived flags, default branch, star/fork counts, primary language, URL and update/push timestamps. `options.sort` (`created`/`updated`/`pushed`/`full_name`, default `full_name`) and `options.direction` (`asc`/`desc`) control ordering; `options.per_page` (1-100, default 30) and `options.page` page through a user with many repos. Shares the same 60 requests/hour per IP unauthenticated ceiling as `listCommits`/`listReleases`/`getRepo`. THROWS on an unknown username (404) or a rate limit (403/429); a user who owns no public repos returns `repositories: []`, not a throw.\n\nCalls `bowmark.providers.github.getUserRepositories`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubGetUserRepositoriesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubGetUserRepositoriesOptions","description":"TypeScript: `GithubGetUserRepositoriesOptions`"}},"required":["username"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/github/listOrganizationRepositories":{"post":{"operationId":"listOrganizationRepositories","summary":"Lists an organization's public repositories off GitHub's own unauthenticated REST endpoint — same row shape as `getUserRepositories` (name, description, fork/archived flags, default branch, stars, for","description":"Lists an organization's public repositories off GitHub's own unauthenticated REST endpoint — same row shape as `getUserRepositories` (name, description, fork/archived flags, default branch, stars, forks, language, URL, timestamps). `options.type` (`all`/`public`/`sources`/`forks`/`member`), `sort`, `direction`, `per_page` (1-100) and `page`. Shares the 60 requests/hour per IP ceiling. THROWS on an unknown organization (404) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.listOrganizationRepositories`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubGetUserRepositoriesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubListOrganizationRepositoriesOptions","description":"TypeScript: `GithubListOrganizationRepositoriesOptions`"}},"required":["org"],"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/github/getUser":{"post":{"operationId":"getUser","summary":"Returns a person's public GitHub profile metadata off GitHub's own unauthenticated REST users endpoint — login, name, company, location, email, bio, X handle, follower/following counts, public repo co","description":"Returns a person's public GitHub profile metadata off GitHub's own unauthenticated REST users endpoint — login, name, company, location, email, bio, X handle, follower/following counts, public repo count, and account creation/update timestamps. Takes a username. Shares the same 60 requests/hour per IP unauthenticated ceiling as `listCommits`/`listReleases`/`getRepo`/`getUserRepositories`. THROWS on an unknown username (404) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.getUser`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubUser>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","description":"TypeScript: `string`"}},"required":["username"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/github/searchUsers":{"post":{"operationId":"searchUsers","summary":"Searches GitHub accounts off GitHub's own unauthenticated user-search endpoint.","description":"Searches GitHub accounts off GitHub's own unauthenticated user-search endpoint. `query` is GitHub's qualifier syntax: `fullname:\"Erik Bernhardsson\"` matches the profile's display name, plus `location:`, `followers:>100`, `type:user`, `in:login`. Returns `totalCount` (GitHub's own count, which may exceed the page) and each hit's login, profile URL, account type and relevance score. A hit carries no name, company or bio: read those with `getUser(login)`. `options.sort` (`followers`/`repositories`/`joined`), `order`, `per_page` (1-100) and `page`. On the stricter 10 requests/minute anonymous search bucket. THROWS on an invalid query (422) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.searchUsers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubSearchUsersResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubSearchUsersOptions","description":"TypeScript: `GithubSearchUsersOptions`"}},"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/github/listOrganizationMembers":{"post":{"operationId":"listOrganizationMembers","summary":"Lists an organization's PUBLIC members off GitHub's own unauthenticated endpoint: login, profile URL, account type.","description":"Lists an organization's PUBLIC members off GitHub's own unauthenticated endpoint: login, profile URL, account type. A member who keeps their membership private is not listed, so absence proves nothing. `options.per_page` (1-100) and `page`. Shares the 60 requests/hour per IP ceiling. THROWS on an unknown organization (404) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.listOrganizationMembers`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListOrganizationMembersResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubListOrganizationMembersOptions","description":"TypeScript: `GithubListOrganizationMembersOptions`"}},"required":["org"],"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/github/getSocialAccounts":{"post":{"operationId":"getSocialAccounts","summary":"Returns the social links a user put on their GitHub profile (X, LinkedIn, Mastodon, Bluesky, YouTube, or `generic` for any other URL), each as `{ provider, url }`, off GitHub's own unauthenticated end","description":"Returns the social links a user put on their GitHub profile (X, LinkedIn, Mastodon, Bluesky, YouTube, or `generic` for any other URL), each as `{ provider, url }`, off GitHub's own unauthenticated endpoint. `getUser` carries only the X handle; this has the rest. A user with none returns `accounts: []`. Shares the 60 requests/hour per IP ceiling. THROWS on an unknown username (404) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.getSocialAccounts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubSocialAccountsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","description":"TypeScript: `string`"}},"required":["username"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/github/getOrganization":{"post":{"operationId":"getOrganization","summary":"Returns an organization's public metadata off GitHub's own unauthenticated REST orgs endpoint — login, name, description, location, blog/website URL, email, avatar URL, public repo count, and account ","description":"Returns an organization's public metadata off GitHub's own unauthenticated REST orgs endpoint — login, name, description, location, blog/website URL, email, avatar URL, public repo count, and account creation/update timestamps. Takes an organization name. Shares the same 60 requests/hour per IP unauthenticated ceiling as `listCommits`/`listReleases`/`getRepo`/`getUserRepositories`. THROWS on an unknown organization (404) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.getOrganization`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubOrganization>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org":{"type":"string","description":"TypeScript: `string`"}},"required":["org"],"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/github/listIssues":{"post":{"operationId":"listIssues","summary":"Lists issues on a public repository off GitHub's own unauthenticated REST issues endpoint — each issue's number, title, body, creator, assignee logins, label names, state, comment count, and created/u","description":"Lists issues on a public repository off GitHub's own unauthenticated REST issues endpoint — each issue's number, title, body, creator, assignee logins, label names, state, comment count, and created/updated/closed timestamps. GitHub's issues endpoint also returns pull requests internally (a PR is an issue with extra fields); this function drops every row that is actually a pull request, so the result is issues only — use `listPullRequests` for PRs. `options.state` (`\"open\"`/`\"closed\"`/`\"all\"`, default `\"open\"`) filters by state; `options.assignee` (a login, or `\"none\"`/`\"*\"`) filters by assignee; `options.labels` is a comma-separated list of label names (AND'd together, GitHub's own syntax); `options.milestone` (a milestone number, or `\"none\"`/`\"*\"`) filters by milestone. `options.per_page` (1-100, default 30) and `options.page` page through results. Shares the same 60 requests/hour per IP unauthenticated ceiling as `listCommits`/`listReleases`/`getRepo`. THROWS on an unknown owner/repo (404) or a rate limit (403/429); a repo with no matching issues returns `issues: []`, not a throw.\n\nCalls `bowmark.providers.github.listIssues`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListIssuesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubListIssuesOptions","description":"TypeScript: `GithubListIssuesOptions`"}},"required":["owner","repo"],"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/github/listPullRequests":{"post":{"operationId":"listPullRequests","summary":"Lists pull requests on a public repository off GitHub's own unauthenticated REST pull-requests endpoint — each PR's number, title, body, creator, state, draft flag, base/head branch names, and created","description":"Lists pull requests on a public repository off GitHub's own unauthenticated REST pull-requests endpoint — each PR's number, title, body, creator, state, draft flag, base/head branch names, and created/updated/closed timestamps. `merged` is derived from GitHub's own `merged_at`, since GitHub reports `state: \"closed\"` for both a merged PR and one closed without merging. `options.state` (`\"open\"`/`\"closed\"`/`\"all\"`, default `\"open\"`) filters by state; `options.base` filters by base branch (e.g. `\"main\"`); `options.head` filters by head branch (`\"user:branch\"`, or `\"branch\"` within the same repo). `options.per_page` (1-100, default 30) and `options.page` page through results. Shares the same 60 requests/hour per IP unauthenticated ceiling as `listCommits`/`listReleases`/`getRepo`/`listIssues`. THROWS on an unknown owner/repo (404) or a rate limit (403/429); a repo with no matching pull requests returns `pullRequests: []`, not a throw.\n\nCalls `bowmark.providers.github.listPullRequests`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListPullRequestsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"options":{"$ref":"#/components/schemas/GithubListPullRequestsOptions","description":"TypeScript: `GithubListPullRequestsOptions`"}},"required":["owner","repo"],"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/github/getIssue":{"post":{"operationId":"getIssue","summary":"Returns the full details of one issue off GitHub's own unauthenticated REST single-issue endpoint — number, title, body, creator, assignee logins, label names, state, whether it is locked, who closed ","description":"Returns the full details of one issue off GitHub's own unauthenticated REST single-issue endpoint — number, title, body, creator, assignee logins, label names, state, whether it is locked, who closed it, comment count, a per-emoji reaction count breakdown, and created/updated/closed timestamps. This door also answers a pull request number, carrying GitHub's own `pull_request` key — `getIssue` THROWS on that and names `getPullRequest` instead, rather than returning an issue shape missing every PR-only field. GitHub's own response carries no timeline events, only a link to a separate endpoint this function does not call. Shares the same 60 requests/hour per IP unauthenticated ceiling as `listIssues`. THROWS on an unknown owner/repo/issue number (404) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.getIssue`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubIssueDetail>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"issueNumber":{"type":"number","description":"TypeScript: `number`"}},"required":["owner","repo","issueNumber"],"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/github/getPullRequest":{"post":{"operationId":"getPullRequest","summary":"Returns the full details of one pull request off GitHub's own unauthenticated REST single-PR endpoint — number, title, body, creator, state, draft flag, base/head branch names, merge status, whether i","description":"Returns the full details of one pull request off GitHub's own unauthenticated REST single-PR endpoint — number, title, body, creator, state, draft flag, base/head branch names, merge status, whether it is locked, who closed it, a per-emoji reaction count breakdown, and created/updated/closed timestamps. The reaction breakdown is read off GitHub's ISSUE representation of the same number, which is where that summary actually lives — the pulls door never carries it — so this spends two requests, like `getProfileReadme`. The `merged` field is derived from GitHub's own `merged_at`, since GitHub reports `state: \"closed\"` for both a merged PR and one closed without merging. Shares the same 60 requests/hour per IP unauthenticated ceiling as `listPullRequests`. THROWS on an unknown owner/repo/PR number (404) or a rate limit (403/429).\n\nCalls `bowmark.providers.github.getPullRequest`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubPullRequestDetail>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"pullRequestNumber":{"type":"number","description":"TypeScript: `number`"}},"required":["owner","repo","pullRequestNumber"],"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/github/listTrendingRepositories":{"post":{"operationId":"listTrendingRepositories","summary":"Returns the repositories on GitHub's public /trending page — today by default, or this week / this month with `since`, optionally narrowed to one programming language (`language: \"rust\"`, GitHub's own","description":"Returns the repositories on GitHub's public /trending page — today by default, or this week / this month with `since`, optionally narrowed to one programming language (`language: \"rust\"`, GitHub's own slug: lowercase, spaces as dashes, e.g. `c++`, `jupyter-notebook`). Each row carries its owner/repo handle, description, primary language, star count, fork count, stars gained in the window (`trendingStarsToday`, named for the daily default), and its own github.com URL. Off the trending page's server-rendered HTML, no API, no login. THROWS if the page structure does not carry the expected `<article class=\"Box-row\">` rows — the page has changed.\n\nCalls `bowmark.providers.github.listTrendingRepositories`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListTrendingRepositoriesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"since":{"anyOf":[{"const":"daily"},{"const":"weekly"},{"const":"monthly"}]},"language":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ since?: \"daily\" | \"weekly\" | \"monthly\"; language?: 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/github/listTopics":{"post":{"operationId":"listTopics","summary":"Returns topics from GitHub's public topics page — each topic's name and its github.com/topics URL.","description":"Returns topics from GitHub's public topics page — each topic's name and its github.com/topics URL. Off the topics page's server-rendered HTML, no API, no login. THROWS if the page structure does not carry the expected topic links — the page has changed.\n\nCalls `bowmark.providers.github.listTopics`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListTopicsResult>`.","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/github/listMarketplaceActions":{"post":{"operationId":"listMarketplaceActions","summary":"Returns GitHub Actions listed on the Marketplace — each one's slug, display name, description, listing type (\"Action\"), and its own github.com/marketplace/actions/<slug> URL.","description":"Returns GitHub Actions listed on the Marketplace — each one's slug, display name, description, listing type (\"Action\"), and its own github.com/marketplace/actions/<slug> URL. `options.query` free-text searches the marketplace, the same box the site itself exposes (e.g. `\"deploy\"`); `options.category` narrows to a marketplace category slug (e.g. `\"deployment\"`, `\"code-quality\"`); `options.page` pages through results (GitHub returns 20 per page). Off the marketplace listing page's server-rendered HTML, no API, no login. A query matching nothing returns `actions: []`, not a throw — only a page whose structure has changed (no listing markup at all, on a query that plainly should match something) throws.\n\nCalls `bowmark.providers.github.listMarketplaceActions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListMarketplaceActionsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"$ref":"#/components/schemas/GithubListMarketplaceActionsOptions","description":"TypeScript: `GithubListMarketplaceActionsOptions`"}},"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/github/getSponsorPage":{"post":{"operationId":"getSponsorPage","summary":"Returns a person's public GitHub Sponsors page — their display name, bio, location, current sponsor count, and every monthly tier (price and reward text).","description":"Returns a person's public GitHub Sponsors page — their display name, bio, location, current sponsor count, and every monthly tier (price and reward text). Off github.com/sponsors/<handle>'s server-rendered HTML, no API, no login — the page never exposes a tier or a sponsor count to a logged-out visitor any differently than a signed-in one. THROWS when the handle has not set up GitHub Sponsors (GitHub redirects `/sponsors/<handle>` to their plain profile) or does not exist (404).\n\nCalls `bowmark.providers.github.getSponsorPage`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubSponsorPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"TypeScript: `string`"}},"required":["handle"],"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/github/searchCode":{"post":{"operationId":"searchCode","summary":"Searches for code across public repositories, off github.com's own rendered code-search results page.","description":"Searches for code across public repositories, off github.com's own rendered code-search results page. NEEDS THE CALLER SIGNED IN — code search has no logged-out door at all: the keyless API 401s and the page ships `logged_in: false` with zero rows for the same query. `query` is GitHub's own code-search syntax (e.g. \"useState language:typescript\"). Returns GitHub's own `blackbirdSearchRoute` payload raw (`raw`) plus `totalCount` and `results` read off it — the signed-in field shape is unmeasured, since no fleet-held GitHub session exists to capture one from. THROWS when signed out or the saved session is stale.\n\nCalls `bowmark.providers.github.searchCode`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubSearchCodeResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"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/github/listNotifications":{"post":{"operationId":"listNotifications","summary":"Lists the signed-in caller's GitHub notifications inbox, 25 per page, newest first — each row's repository, issue/PR number, title, type (PullRequest, Issue, Discussion, SecurityAlert, …), why they go","description":"Lists the signed-in caller's GitHub notifications inbox, 25 per page, newest first — each row's repository, issue/PR number, title, type (PullRequest, Issue, Discussion, SecurityAlert, …), why they got it (author, mention, subscribed, review requested, …), unread flag, last activity time and link. Off github.com/notifications' own server-rendered page. NEEDS THE CALLER SIGNED IN: logged out, github.com redirects the route to /login. `query` is github.com's own notification filter (\"is:unread\", \"reason:mention\", \"repo:owner/name\"); pass a page's `nextCursor` back as `after` for the next 25. An empty `notifications` with no error is a real empty result for that filter. THROWS when signed out or the saved session is stale.\n\nCalls `bowmark.providers.github.listNotifications`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListNotificationsResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"$ref":"#/components/schemas/GithubListNotificationsOptions","description":"TypeScript: `GithubListNotificationsOptions`"},"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/github/listStarredRepositories":{"post":{"operationId":"listStarredRepositories","summary":"Lists repositories the signed-in caller has starred — name, full name, description, star count, and URL — paged (per_page up to 100, page from 1).","description":"Lists repositories the signed-in caller has starred — name, full name, description, star count, and URL — paged (per_page up to 100, page from 1). NEEDS THE CALLER SIGNED IN, to know WHO the caller is; the list itself comes off GitHub's public REST stars door for that account, so stars on PRIVATE repositories are not included. THROWS when signed out or the saved session is invalid.\n\nCalls `bowmark.providers.github.listStarredRepositories`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubListStarredRepositoriesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"object","properties":{"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ per_page?: number; page?: number }`"},"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/github/updateIssue":{"post":{"operationId":"updateIssue","summary":"Renames an issue's TITLE off github.com's own issue-viewer web mutation (`PUT /{owner}/{repo}/issues/{number}/title`) — NEEDS THE CALLER SIGNED IN, same door and same wall as every authFunction here: ","description":"Renames an issue's TITLE off github.com's own issue-viewer web mutation (`PUT /{owner}/{repo}/issues/{number}/title`) — NEEDS THE CALLER SIGNED IN, same door and same wall as every authFunction here: the route answers 404 \"Not Found\" to an unauthenticated request (github.com's own way of refusing to confirm the issue exists either way), and the signed-in success shape is unmeasured, since no fleet-held GitHub session exists to capture one from. `updates` supports `{ title }` only for now — body, state (open/closed), assignees, labels and milestone are real mutations on this same issue viewer but not yet built (see packages/providers/github/BUILD_QUEUE.md). THROWS when signed out, the saved session is stale, or the issue does not exist.\n\nCalls `bowmark.providers.github.updateIssue`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubUpdateIssueTitleResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"issueNumber":{"type":"number","description":"TypeScript: `number`"},"updates":{"type":"object","properties":{"title":{"type":"string"}},"required":["title"],"additionalProperties":true,"description":"TypeScript: `{ title: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo","issueNumber","updates"],"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/github/createIssue":{"post":{"operationId":"createIssue","summary":"Opens a new issue on a repository, off github.com's own issue-creation mutation (`POST /_ghui/issues?queryId=...`, the persisted-GraphQL door the \"Create\" button on /issues/new calls) — NEEDS THE CALL","description":"Opens a new issue on a repository, off github.com's own issue-creation mutation (`POST /_ghui/issues?queryId=...`, the persisted-GraphQL door the \"Create\" button on /issues/new calls) — NEEDS THE CALLER SIGNED IN: the route answers UNAUTHENTICATED (\"The `createIssue` mutation cannot be run anonymously\") to a signed-out request. Takes a title and optional markdown body; the repository id is read off GitHub's public API unless `options.repositoryId` is given (needed for a private repo). Returns GitHub's own created-issue object. THROWS when signed out, the saved session is stale, or issues are disabled.\n\nCalls `bowmark.providers.github.createIssue`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubCreateIssueResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"title":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"body":{"type":"string"},"repositoryId":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ body?: string; repositoryId?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo","title"],"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/github/createPullRequest":{"post":{"operationId":"createPullRequest","summary":"Opens a pull request from `head` into `base` for the signed-in caller, off github.com's own compare page: it loads `/{owner}/{repo}/compare/{base}...{head}`, reads that page's \"Create pull request\" fo","description":"Opens a pull request from `head` into `base` for the signed-in caller, off github.com's own compare page: it loads `/{owner}/{repo}/compare/{base}...{head}`, reads that page's \"Create pull request\" form (action and CSRF token) and posts it back with the title and optional markdown body. NEEDS THE CALLER SIGNED IN — logged out, the compare page carries no form at all. Same-repository branches only (`head` is a branch name). Returns the new pull request's number and URL. THROWS when signed out, the saved session is stale, the branches have nothing to compare, or a pull request between them is already open.\n\nCalls `bowmark.providers.github.createPullRequest`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubPullRequestCreated>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"title":{"type":"string","description":"TypeScript: `string`"},"head":{"type":"string","description":"TypeScript: `string`"},"base":{"type":"string","description":"TypeScript: `string`"},"options":{"type":"object","properties":{"body":{"type":"string"},"draft":{"type":"boolean"}},"additionalProperties":true,"description":"TypeScript: `{ body?: string; draft?: boolean }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo","title","head","base"],"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/github/createComment":{"post":{"operationId":"createComment","summary":"Adds a comment to an issue or pull request, off github.com's own issue-viewer web mutation (`POST /{owner}/{repo}/issues/{number}/comments.json?queryId=...`, the persisted-GraphQL-query door the \"Comm","description":"Adds a comment to an issue or pull request, off github.com's own issue-viewer web mutation (`POST /{owner}/{repo}/issues/{number}/comments.json?queryId=...`, the persisted-GraphQL-query door the \"Comment\" button itself calls) — NEEDS THE CALLER SIGNED IN, same door and same wall as `updateIssue`: the route answers 404 \"Not Found\" to an unauthenticated request, and the signed-in success shape is unmeasured, since no fleet-held GitHub session exists to capture one from. THROWS when signed out, the saved session is stale, or the issue/PR does not exist.\n\nCalls `bowmark.providers.github.createComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubCommentResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"issueNumber":{"type":"number","description":"TypeScript: `number`"},"body":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo","issueNumber","body"],"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/github/updateComment":{"post":{"operationId":"updateComment","summary":"Edits an existing comment on an issue or pull request, off github.com's own issue-viewer web mutation (`PATCH /{owner}/{repo}/issues/{number}/comments/{commentId}.json?queryId=...`) — NEEDS THE CALLER","description":"Edits an existing comment on an issue or pull request, off github.com's own issue-viewer web mutation (`PATCH /{owner}/{repo}/issues/{number}/comments/{commentId}.json?queryId=...`) — NEEDS THE CALLER SIGNED IN, same door and same wall as `createComment`. `commentId` is the comment's numeric database id (its page URL's `#issuecomment-<id>` fragment). THROWS when signed out, the saved session is stale, the comment does not exist, or the signed-in caller does not own it.\n\nCalls `bowmark.providers.github.updateComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubCommentResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"issueNumber":{"type":"number","description":"TypeScript: `number`"},"commentId":{"type":"number","description":"TypeScript: `number`"},"body":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo","issueNumber","commentId","body"],"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/github/deleteComment":{"post":{"operationId":"deleteComment","summary":"Deletes a comment on an issue or pull request, off github.com's own issue-viewer web mutation (`DELETE /{owner}/{repo}/issues/{number}/comments/{commentId}.json?queryId=...`) — NEEDS THE CALLER SIGNED","description":"Deletes a comment on an issue or pull request, off github.com's own issue-viewer web mutation (`DELETE /{owner}/{repo}/issues/{number}/comments/{commentId}.json?queryId=...`) — NEEDS THE CALLER SIGNED IN, same door and same wall as `createComment`. THROWS when signed out, the saved session is stale, the comment does not exist, or the signed-in caller does not own it.\n\nCalls `bowmark.providers.github.deleteComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubCommentResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"issueNumber":{"type":"number","description":"TypeScript: `number`"},"commentId":{"type":"number","description":"TypeScript: `number`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo","issueNumber","commentId"],"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/github/updatePullRequest":{"post":{"operationId":"updatePullRequest","summary":"Renames a pull request's TITLE off the same door `updateIssue` uses (`PUT /{owner}/{repo}/issues/{number}/title`) — a pull request is an Issue-type node in GitHub's own data model, and the door makes ","description":"Renames a pull request's TITLE off the same door `updateIssue` uses (`PUT /{owner}/{repo}/issues/{number}/title`) — a pull request is an Issue-type node in GitHub's own data model, and the door makes no distinction. NEEDS THE CALLER SIGNED IN, same door and same wall as `updateIssue`. `updates` supports `{ title }` only for now — body, state (open/closed) and base branch are separate doors on this same pull request, not yet surveyed (see packages/providers/github/BUILD_QUEUE.md). THROWS when signed out, the saved session is stale, or the pull request does not exist.\n\nCalls `bowmark.providers.github.updatePullRequest`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubUpdateIssueTitleResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"pullNumber":{"type":"number","description":"TypeScript: `number`"},"updates":{"type":"object","properties":{"title":{"type":"string"}},"required":["title"],"additionalProperties":true,"description":"TypeScript: `{ title: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo","pullNumber","updates"],"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/github/watchRepository":{"post":{"operationId":"watchRepository","summary":"Watches a repository (all activity) for the signed-in caller, off github.com's own watch-dropdown web mutation (`POST /notifications/subscribe`, `do=subscribed`).","description":"Watches a repository (all activity) for the signed-in caller, off github.com's own watch-dropdown web mutation (`POST /notifications/subscribe`, `do=subscribed`). NEEDS THE CALLER SIGNED IN. THROWS when signed out, the saved session is stale, or the repository does not exist.\n\nCalls `bowmark.providers.github.watchRepository`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubSubscriptionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo"],"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/github/unwatchRepository":{"post":{"operationId":"unwatchRepository","summary":"Stops watching a repository for the signed-in caller — returns it to GitHub's default 'participating and @mentions' state, which is what the site's own unwatch does (`POST /notifications/subscribe`, `","description":"Stops watching a repository for the signed-in caller — returns it to GitHub's default 'participating and @mentions' state, which is what the site's own unwatch does (`POST /notifications/subscribe`, `do=included`). NEEDS THE CALLER SIGNED IN. THROWS when signed out, the saved session is stale, or the repository does not exist.\n\nCalls `bowmark.providers.github.unwatchRepository`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubSubscriptionResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo"],"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/github/starRepository":{"post":{"operationId":"starRepository","summary":"Stars a repository for the signed-in caller, off github.com's own star form (`POST /{owner}/{repo}/star`).","description":"Stars a repository for the signed-in caller, off github.com's own star form (`POST /{owner}/{repo}/star`). NEEDS THE CALLER SIGNED IN. THROWS when signed out, the saved session is stale, or the repository does not exist.\n\nCalls `bowmark.providers.github.starRepository`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubStarResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo"],"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/github/unstarRepository":{"post":{"operationId":"unstarRepository","summary":"Removes a repository from the signed-in caller's stars, off github.com's own unstar form (`POST /{owner}/{repo}/unstar`).","description":"Removes a repository from the signed-in caller's stars, off github.com's own unstar form (`POST /{owner}/{repo}/unstar`). NEEDS THE CALLER SIGNED IN. THROWS when signed out, the saved session is stale, or the repository does not exist.\n\nCalls `bowmark.providers.github.unstarRepository`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubStarResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo"],"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/github/mergePullRequest":{"post":{"operationId":"mergePullRequest","summary":"Merges a pull request into its base branch for the signed-in caller, off github.com's own merge box (`POST /{owner}/{repo}/pull/{number}/page_data/merge`).","description":"Merges a pull request into its base branch for the signed-in caller, off github.com's own merge box (`POST /{owner}/{repo}/pull/{number}/page_data/merge`). `mergeMethod` defaults to 'merge'; 'squash' and 'rebase' match the merge box's own options, and `commitTitle`/`commitMessage` override the merge commit's text. NEEDS THE CALLER SIGNED IN with write access to the repository. THROWS when signed out, the saved session is stale, or the pull request cannot be merged (conflicts, failing required checks, no write access).\n\nCalls `bowmark.providers.github.mergePullRequest`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubMergeResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"pullNumber":{"type":"number","description":"TypeScript: `number`"},"options":{"type":"object","properties":{"mergeMethod":{"anyOf":[{"const":"merge"},{"const":"squash"},{"const":"rebase"}]},"commitTitle":{"type":"string"},"commitMessage":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ mergeMethod?: 'merge' | 'squash' | 'rebase'; commitTitle?: string; commitMessage?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo","pullNumber"],"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/github/createReview":{"post":{"operationId":"createReview","summary":"Submits a review on a pull request for the signed-in caller, off github.com's own review box (`PUT /{owner}/{repo}/pull/{number}/page_data/submit_review`).","description":"Submits a review on a pull request for the signed-in caller, off github.com's own review box (`PUT /{owner}/{repo}/pull/{number}/page_data/submit_review`). `body` is required for 'request_changes' and 'comment'. `headSha` defaults to the pull request's current head, read from GitHub's public API; pass it for a private repository. NEEDS THE CALLER SIGNED IN. THROWS when signed out, the session is stale, or GitHub refuses the review (your own pull request, a moved head).\n\nCalls `bowmark.providers.github.createReview`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubReviewResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"pullNumber":{"type":"number","description":"TypeScript: `number`"},"review":{"type":"object","properties":{"event":{"anyOf":[{"const":"approve"},{"const":"request_changes"},{"const":"comment"}]},"body":{"type":"string"},"headSha":{"type":"string"}},"required":["event"],"additionalProperties":true,"description":"TypeScript: `{ event: 'approve' | 'request_changes' | 'comment'; body?: string; headSha?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo","pullNumber","review"],"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/github/createReviewComment":{"post":{"operationId":"createReviewComment","summary":"Adds an inline comment to a pull request's diff for the signed-in caller, off github.com's own Files-changed comment box (`POST /{owner}/{repo}/pull/{number}/page_data/create_review_comment`).","description":"Adds an inline comment to a pull request's diff for the signed-in caller, off github.com's own Files-changed comment box (`POST /{owner}/{repo}/pull/{number}/page_data/create_review_comment`). `line` is a line number in the file (right side = the new version, the default; 'left' = the old one); add `startLine` for a multi-line range; omit `line` to comment on the whole file. Posted immediately, not into a pending review. `headSha`/`baseSha` default to the pull request's own, read from GitHub's public API; pass both for a private repository. NEEDS THE CALLER SIGNED IN. THROWS when signed out, the session is stale, or the line is not in the diff.\n\nCalls `bowmark.providers.github.createReviewComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GithubReviewCommentResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"TypeScript: `string`"},"repo":{"type":"string","description":"TypeScript: `string`"},"pullNumber":{"type":"number","description":"TypeScript: `number`"},"comment":{"type":"object","properties":{"body":{"type":"string"},"path":{"type":"string"},"line":{"type":"number"},"side":{"anyOf":[{"const":"left"},{"const":"right"}]},"startLine":{"type":"number"},"startSide":{"anyOf":[{"const":"left"},{"const":"right"}]},"headSha":{"type":"string"},"baseSha":{"type":"string"}},"required":["body","path"],"additionalProperties":true,"description":"TypeScript: `{ body: string; path: string; line?: number; side?: 'left' | 'right'; startLine?: number; startSide?: 'left' | 'right'; headSha?: string; baseSha?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["owner","repo","pullNumber","comment"],"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}}},"GithubGetFileContentsOptions":{"type":"object","properties":{"ref":{"type":"string"}},"additionalProperties":true},"GithubGetUserRepositoriesOptions":{"type":"object","properties":{"sort":{"anyOf":[{"const":"created"},{"const":"updated"},{"const":"pushed"},{"const":"full_name"}]},"direction":{"anyOf":[{"const":"asc"},{"const":"desc"}]},"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubListCommitsOptions":{"type":"object","properties":{"sha":{"type":"string"},"since":{"type":"string"},"until":{"type":"string"},"author":{"type":"string"},"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubListContributorsOptions":{"type":"object","properties":{"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubListIssueCommentsOptions":{"type":"object","properties":{"since":{"type":"string"},"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubListIssuesOptions":{"type":"object","properties":{"state":{"anyOf":[{"const":"open"},{"const":"closed"},{"const":"all"}]},"assignee":{"type":"string"},"labels":{"type":"string"},"milestone":{"type":"string"},"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubListMarketplaceActionsOptions":{"type":"object","properties":{"query":{"type":"string"},"category":{"type":"string"},"page":{"type":"number"}},"additionalProperties":true},"GithubListNotificationsOptions":{"type":"object","properties":{"query":{"type":"string"},"after":{"type":"string"}},"additionalProperties":true},"GithubListOrganizationMembersOptions":{"type":"object","properties":{"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubListOrganizationRepositoriesOptions":{"type":"object","properties":{"type":{"anyOf":[{"const":"all"},{"const":"public"},{"const":"sources"},{"const":"forks"},{"const":"member"}]},"sort":{"anyOf":[{"const":"created"},{"const":"updated"},{"const":"pushed"},{"const":"full_name"}]},"direction":{"anyOf":[{"const":"asc"},{"const":"desc"}]},"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubListPullRequestFilesOptions":{"type":"object","properties":{"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubListPullRequestsOptions":{"type":"object","properties":{"state":{"anyOf":[{"const":"open"},{"const":"closed"},{"const":"all"}]},"base":{"type":"string"},"head":{"type":"string"},"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubListReleasesOptions":{"type":"object","properties":{"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubListSecurityAdvisoriesOptions":{"type":"object","properties":{"ecosystem":{"type":"string"},"package":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"},"severity":{"type":"string"},"per_page":{"type":"number"}},"additionalProperties":true},"GithubListWorkflowRunsOptions":{"type":"object","properties":{"branch":{"type":"string"},"event":{"type":"string"},"status":{"type":"string"},"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubSearchIssuesOptions":{"type":"object","properties":{"sort":{"anyOf":[{"const":"comments"},{"const":"reactions"},{"const":"created"},{"const":"updated"}]},"order":{"anyOf":[{"const":"asc"},{"const":"desc"}]},"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubSearchRepositoriesOptions":{"type":"object","properties":{"sort":{"anyOf":[{"const":"stars"},{"const":"forks"},{"const":"help-wanted-issues"},{"const":"updated"}]},"order":{"anyOf":[{"const":"asc"},{"const":"desc"}]},"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true},"GithubSearchUsersOptions":{"type":"object","properties":{"sort":{"anyOf":[{"const":"followers"},{"const":"repositories"},{"const":"joined"}]},"order":{"anyOf":[{"const":"asc"},{"const":"desc"}]},"per_page":{"type":"number"},"page":{"type":"number"}},"additionalProperties":true}}}}