{"openapi":"3.1.0","info":{"title":"YouTube API (Bowmark)","version":"bc1511aab02c","description":"A YouTube video's own caption transcript, read off the site's own Transcript panel — timestamped lines plus the full text as one string. Language selection is not offered yet; this reads whichever track the panel shows by default.\n\nEvery function Bowmark has for YouTube (youtube.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/youtube/search":{"post":{"operationId":"search","summary":"Searches YouTube the way its search box does and returns the videos on the results page — id, url, title, channel, upload age, length and views.","description":"Searches YouTube the way its search box does and returns the videos on the results page — id, url, title, channel, upload age, length and views. `lengthSeconds` sits beside `length` so a time budget can be compared without parsing the display string. `uploadedWithin`, `type`, `duration`, `features` and `sortBy` apply YouTube's own search filters (the same panel a browser shows), and compose — pass several at once, e.g. a short, captioned video from this week. `duration: \"short\"` is YouTube's own \"Under 3 minutes\" band, `\"medium\"` is 3-20 minutes, `\"long\"` is over 20. `sortBy: \"popularity\"` is the only sort besides relevance the site itself offers today. Rows come back in YouTube's own order otherwise, which is NOT newest first, so sort on `publishedAgeSeconds` (smaller is newer) to find the most recent. `limit` (1-200) keeps reading the result pages YouTube loads as you scroll until that many distinct videos are in hand, so `{ query, limit: 100 }` is one call for 100 videos; without it you get the first page, about 20-30. Pass a video's `url` or `videoId` straight to `getTranscript`.\n\nCalls `bowmark.providers.youtube.search`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeSearchVideo[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"type":"string"},"uploadedWithin":{"anyOf":[{"const":"today"},{"const":"week"},{"const":"month"},{"const":"year"}]},"type":{"anyOf":[{"const":"video"},{"const":"channel"},{"const":"playlist"},{"const":"movie"},{"const":"shorts"}]},"duration":{"anyOf":[{"const":"short"},{"const":"medium"},{"const":"long"}]},"features":{"type":"array","items":{"anyOf":[{"const":"live"},{"const":"4k"},{"const":"hd"},{"const":"subtitles"},{"const":"creativeCommons"},{"const":"360"},{"const":"vr180"},{"const":"3d"},{"const":"hdr"},{"const":"location"},{"const":"purchased"}]}},"sortBy":{"const":"popularity"},"limit":{"type":"number"}},"required":["query"],"additionalProperties":true,"description":"TypeScript: `{ query: string; uploadedWithin?: \"today\" | \"week\" | \"month\" | \"year\"; type?: \"video\" | \"channel\" | \"playlist\" | \"movie\" | \"shorts\"; duration?: \"short\" | \"medium\" | \"long\"; features?: (\"live\" | \"4k\" | \"hd\" | \"subtitles\" | \"creativeCommons\" | \"360\" | \"vr180\" | \"3d\" | \"hdr\" | \"location\" | \"purchased\")[]; sortBy?: \"popularity\"; limit?: number }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/suggestSearches":{"post":{"operationId":"suggestSearches","summary":"YouTube's own autocomplete for a partial query — the dropdown it shows while somebody is still typing, in the site's own ranked order.","description":"YouTube's own autocomplete for a partial query — the dropdown it shows while somebody is still typing, in the site's own ranked order. Use it to turn a vague phrase into the wording YouTube actually indexes before spending a call on `search`. A query matching nothing returns a real, honest empty array rather than throwing.\n\nCalls `bowmark.providers.youtube.suggestSearches`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<string[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"],"additionalProperties":true,"description":"TypeScript: `{ query: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/getDislikes":{"post":{"operationId":"getDislikes","summary":"The dislike count, like count and dislike ratio for up to 50 videos in one call, with no sign-in.","description":"The dislike count, like count and dislike ratio for up to 50 videos in one call, with no sign-in. YouTube hides dislike counts, so these are an ESTIMATE from the Return YouTube Dislike project (extrapolated from its own users), not YouTube's number: each item says `estimated: true` and `source: \"returnyoutubedislike\"`. Use it to show dislikes, rank a search's results by most disliked / highest dislike ratio, or hide heavily disliked videos. `videos` takes 11-character ids or any watch/shorts/youtu.be URL (a search row's `videoId` goes straight in); duplicates are read once, and past 50 the rest are dropped with a warning. `ratio` is dislikes / (likes + dislikes), null when there are no votes. A video that fails comes back as a warning; if every video fails the call throws.\n\nCalls `bowmark.providers.youtube.getDislikes`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeDislikes>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"videos":{"type":"array","items":{"type":"string"}}},"required":["videos"],"additionalProperties":true,"description":"TypeScript: `{ videos: string[] }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/getTranscript":{"post":{"operationId":"getTranscript","summary":"Returns a YouTube video's own caption transcript.","description":"Returns a YouTube video's own caption transcript. `video` is a bare 11-character video id or any watch/shorts/embed/live/youtu.be URL. `segments` is [] — a real, honest answer — when the video has no caption track at all.\n\nCalls `bowmark.providers.youtube.getTranscript`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeTranscript>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"string"},{"type":"object","properties":{"video":{"type":"string"}},"required":["video"],"additionalProperties":true}],"description":"TypeScript: `string | { video: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/findChannel":{"post":{"operationId":"findChannel","summary":"Resolves a channel `@handle`, a channel/handle URL, or a plain channel name to its canonical id — the door every other channel function here takes a channelId through.","description":"Resolves a channel `@handle`, a channel/handle URL, or a plain channel name to its canonical id — the door every other channel function here takes a channelId through. An `@handle` or URL goes through YouTube's own `navigation/resolve_url` and returns just the id and canonical URL (no title — that costs a second call, which `getChannel` makes). A plain name runs a channel-filtered search and returns the first, best-matching channel with its title, subscriber count and thumbnail. Returns null when nothing resolves — not a real answer to build a `getChannel` call on.\n\nCalls `bowmark.providers.youtube.findChannel`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeChannelRef | null>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"],"additionalProperties":true,"description":"TypeScript: `{ query: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/getVideo":{"post":{"operationId":"getVideo","summary":"Everything the watch page says about one video without playing it: title, channel name and id, full description, view count, like count, length in seconds, publish and upload dates, category, the uplo","description":"Everything the watch page says about one video without playing it: title, channel name and id, full description, view count, like count, length in seconds, publish and upload dates, category, the uploader's own keywords, every thumbnail size, and whether it is live now, was ever live, or is unlisted. `video` is a bare 11-character video id or any watch/shorts/embed/live/youtu.be URL, exactly as `getTranscript` takes it.\n\nCalls `bowmark.providers.youtube.getVideo`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeVideo>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"}},"required":["video"],"additionalProperties":true,"description":"TypeScript: `{ video: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listComments":{"post":{"operationId":"listComments","summary":"What people said under a video — each comment's author, text, like count (YouTube's own abbreviated text, e.g.","description":"What people said under a video — each comment's author, text, like count (YouTube's own abbreviated text, e.g. \"316K\"), how long ago it was posted, its reply count, and whether the thread is pinned or was hearted by the creator. `sortBy` picks YouTube's own \"Top\" or \"Newest\" ordering (default Top) on the first call; pass back `continuation` alone — no `video` needed, it is self-contained — to read the next page. `continuation` is null once there are no more pages.\n\nCalls `bowmark.providers.youtube.listComments`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeCommentPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"video":{"type":"string"},"sortBy":{"anyOf":[{"const":"top"},{"const":"newest"}]}},"required":["video"],"additionalProperties":true},{"type":"object","properties":{"continuation":{"type":"string"}},"required":["continuation"],"additionalProperties":true}],"description":"TypeScript: `{ video: string; sortBy?: \"top\" | \"newest\" } | { continuation: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listCommentReplies":{"post":{"operationId":"listCommentReplies","summary":"The replies under one comment thread, which YouTube hides behind a \"N replies\" button and never ships with the thread itself.","description":"The replies under one comment thread, which YouTube hides behind a \"N replies\" button and never ships with the thread itself. `continuation` is a thread's own `repliesContinuation` off a `listComments` row (null when it has no replies) for the first page, or this function's own returned `continuation` for the next one; it is null once there are no more pages. Each reply carries its author, text, like count and whether the creator hearted it — no reply count or pinned flag, since a reply cannot itself be a thread or be pinned.\n\nCalls `bowmark.providers.youtube.listCommentReplies`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeCommentReplyPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"continuation":{"type":"string"}},"required":["continuation"],"additionalProperties":true,"description":"TypeScript: `{ continuation: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listRelatedVideos":{"post":{"operationId":"listRelatedVideos","summary":"The videos YouTube itself puts next to this one — the \"up next\" rail — each with its id, title, channel, YouTube's own abbreviated view-count text (e.g.","description":"The videos YouTube itself puts next to this one — the \"up next\" rail — each with its id, title, channel, YouTube's own abbreviated view-count text (e.g. \"206M\", without the word \"views\"), upload age, length and thumbnail. `video` is a bare 11-character video id or any watch/shorts/embed/live/youtu.be URL, exactly as `getTranscript` takes it. Pass back `continuation` alone — no `video` needed — to read the next page; it is null once YouTube offers no further \"Show more\", which some videos never do even on page 1.\n\nCalls `bowmark.providers.youtube.listRelatedVideos`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeRelatedVideoPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"video":{"type":"string"}},"required":["video"],"additionalProperties":true},{"type":"object","properties":{"continuation":{"type":"string"}},"required":["continuation"],"additionalProperties":true}],"description":"TypeScript: `{ video: string } | { continuation: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listChapters":{"post":{"operationId":"listChapters","summary":"A video's own chapter markers — the labelled sections YouTube shows on the scrub bar — each with its title, start time in seconds and YouTube's own display text for that time (e.g.","description":"A video's own chapter markers — the labelled sections YouTube shows on the scrub bar — each with its title, start time in seconds and YouTube's own display text for that time (e.g. \"1:03:10\"). `video` is a bare 11-character video id or any watch/shorts/embed/live/youtu.be URL, exactly as `getTranscript` takes it. `[]` when the video has no chapters at all — a real, honest answer, not a failure.\n\nCalls `bowmark.providers.youtube.listChapters`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeChapter[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"}},"required":["video"],"additionalProperties":true,"description":"TypeScript: `{ video: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/getLiveChat":{"post":{"operationId":"getLiveChat","summary":"The messages scrolling past a live stream right now — each with its author, text and YouTube's own microsecond timestamp.","description":"The messages scrolling past a live stream right now — each with its author, text and YouTube's own microsecond timestamp. `video` is a bare 11-character video id or any watch/shorts/embed/live/youtu.be URL, exactly as `getTranscript` takes it, for the FIRST call; pass back `continuation` alone — no `video` needed — to read what arrived since. `open` is false, with the site's own `notice` sentence (e.g. \"Chat is disabled for this live stream.\"), when the stream has never gone live, its chat is off, or it already ended — nothing in the response tells those three apart. `continuation` is null once the stream stops offering one.\n\nCalls `bowmark.providers.youtube.getLiveChat`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeLiveChat>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"video":{"type":"string"}},"required":["video"],"additionalProperties":true},{"type":"object","properties":{"continuation":{"type":"string"}},"required":["continuation"],"additionalProperties":true}],"description":"TypeScript: `{ video: string } | { continuation: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listCaptionTracks":{"post":{"operationId":"listCaptionTracks","summary":"Which languages a video's captions are available in, whether each was written by a human/uploader or generated by YouTube itself, and which one `getTranscript` reads by default.","description":"Which languages a video's captions are available in, whether each was written by a human/uploader or generated by YouTube itself, and which one `getTranscript` reads by default. `video` is a bare 11-character video id or any watch/shorts/embed/live/youtu.be URL, exactly as `getTranscript` takes it. `[]` when the video has no captions at all — a real, honest answer, not a failure. Does not itself return caption text or a language choice for `getTranscript`, which today always reads the default track.\n\nCalls `bowmark.providers.youtube.listCaptionTracks`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeCaptionTrack[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"}},"required":["video"],"additionalProperties":true,"description":"TypeScript: `{ video: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listStreamFormats":{"post":{"operationId":"listStreamFormats","summary":"The renditions a video is actually available in — resolution, frame rate, codec, bitrate, approximate file size and duration for each video and audio stream YouTube holds.","description":"The renditions a video is actually available in — resolution, frame rate, codec, bitrate, approximate file size and duration for each video and audio stream YouTube holds. Answers \"is this available in 4K\" and \"how big is it\". It returns the CATALOGUE of formats, not a playable or downloadable link — `getPlayableStream` is the link.\n\nCalls `bowmark.providers.youtube.listStreamFormats`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeStreamFormat[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"}},"required":["video"],"additionalProperties":true,"description":"TypeScript: `{ video: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/getPlayableStream":{"post":{"operationId":"getPlayableStream","summary":"A link a plain HTML `<video>` element can play for one ordinary uploaded video: a signed googlevideo.com file carrying video and audio together (360p mp4 today), valid until `expiresAt` (about six hou","description":"A link a plain HTML `<video>` element can play for one ordinary uploaded video: a signed googlevideo.com file carrying video and audio together (360p mp4 today), valid until `expiresAt` (about six hours) and playable from any address. `video` is a bare 11-character id or any watch/shorts/embed/youtu.be URL, as `getTranscript` takes it. The bytes stream from YouTube straight to whoever plays the link; the call itself moves about 2 KB. Throws for a video YouTube will not play to anyone, and when no exit was handed a playable file (a live stream, an age-gated video): fall back to YouTube's own embed player then. Not for downloading: the link is the stream, not a file Bowmark saves.\n\nCalls `bowmark.providers.youtube.getPlayableStream`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubePlayableStream>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"}},"required":["video"],"additionalProperties":true,"description":"TypeScript: `{ video: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/getPlayback":{"post":{"operationId":"getPlayback","summary":"Every way to play one video, for you to choose from: YouTube's embed (`embed.url`, its own player in an iframe, ads included) and every file YouTube serves (`files.muxed` is video+audio in one 360p fi","description":"Every way to play one video, for you to choose from: YouTube's embed (`embed.url`, its own player in an iframe, ads included) and every file YouTube serves (`files.muxed` is video+audio in one 360p file; `files.videoOnly` is every size from 144p to 2160p, each played in a muted `<video>` beside ONE `files.audioOnly` file in an `<audio>`). `video` is a bare 11-character id or any watch/shorts/embed/live/youtu.be URL. Choose from what the user asked for: no ads, no end-screen suggestions or no site chrome → files; a particular resolution, \"the highest\" or \"save data\" → files; the page's own controls, a looping segment, a frame grab, picture-in-picture or audio only → files; a live stream, members-only, age-restricted or DRM'd video → embed; YouTube's own comments, chapters, likes or captions inside the player → embed; no preference → files, falling back to the embed. A page may offer both and let the viewer switch. Inside a jig page, the page kit's `player.mount(box, menu, { mode, quality })` plays any of these and keeps a pair in sync (a jig helper, not a library function). The file URLs play from any address, need no particular Referer, and expire at `expiresAt` (about six hours). The bytes go from YouTube straight to the player; the call moves about 5 KB. A live, age-gated, region- or members-blocked video comes back with empty `files`, the embed, and a `warnings` line saying why. Throws only for a removed or private video. `getPlayableStream` is the one-call shortcut to the 360p muxed file.\n\nCalls `bowmark.providers.youtube.getPlayback`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubePlayback>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"}},"required":["video"],"additionalProperties":true,"description":"TypeScript: `{ video: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listHashtagVideos":{"post":{"operationId":"listHashtagVideos","summary":"The videos on one of YouTube's own hashtag pages (`youtube.com/hashtag/<tag>`) — a topic feed reachable from a bare word, with no channel and no search ranking in the way.","description":"The videos on one of YouTube's own hashtag pages (`youtube.com/hashtag/<tag>`) — a topic feed reachable from a bare word, with no channel and no search ranking in the way. Same row shape `search` returns. `hashtag` is the bare tag, with or without a leading \"#\". This is a curated, CAPPED feed rather than a paged one — no tag measured carries a \"show more\", so `[]` back means the site had nothing to show (\"Not much to see right now\"), not that the call failed.\n\nCalls `bowmark.providers.youtube.listHashtagVideos`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeSearchVideo[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"hashtag":{"type":"string"}},"required":["hashtag"],"additionalProperties":true,"description":"TypeScript: `{ hashtag: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/getChannel":{"post":{"operationId":"getChannel","summary":"A channel's own page as facts: display name, @handle, an abbreviated subscriber count text (YouTube never publishes an exact one), the About tab's full description, total video count, lifetime view co","description":"A channel's own page as facts: display name, @handle, an abbreviated subscriber count text (YouTube never publishes an exact one), the About tab's full description, total video count, lifetime view count, country, the ISO date it joined, the links it lists (resolved to their real destination, not YouTube's redirect wrapper), and its avatar and banner images. `channel` is a channel id (`UC…`), an `@handle`, or a channel URL — not a plain name, which `findChannel` resolves to an id first; a getVideo or search row's own `channelId` (or the row itself) is accepted as-is. Every field past `channelId`/`handle`/`title` comes off the About panel; on the rare response that carries no panel at all they come back null/empty rather than throwing.\n\nCalls `bowmark.providers.youtube.getChannel`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeChannel>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"channel":{"type":"string"}},"required":["channel"],"additionalProperties":true,"description":"TypeScript: `{ channel: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listChannelVideos":{"post":{"operationId":"listChannelVideos","summary":"What a channel has published, newest first and paged — each video's id, url, title, YouTube's own abbreviated view-count text (e.g.","description":"What a channel has published, newest first and paged — each video's id, url, title, YouTube's own abbreviated view-count text (e.g. \"101M views\"), upload age, length and thumbnail. `channel` takes a channel id, an @handle, or a channel URL, exactly as `getChannel` does — not a plain name, which `findChannel` resolves first. Pass back `continuation` alone — no `channel` needed — to read the next page; it is null once there are no more pages.\n\nCalls `bowmark.providers.youtube.listChannelVideos`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeChannelVideoPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"channel":{"type":"string"}},"required":["channel"],"additionalProperties":true},{"type":"object","properties":{"continuation":{"type":"string"}},"required":["continuation"],"additionalProperties":true}],"description":"TypeScript: `{ channel: string } | { continuation: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listChannelShorts":{"post":{"operationId":"listChannelShorts","summary":"What a channel has published to its Shorts tab, in the site's own order and paged — each short's id, its `/shorts/<id>` url, title, and YouTube's own abbreviated view-count text (e.g.","description":"What a channel has published to its Shorts tab, in the site's own order and paged — each short's id, its `/shorts/<id>` url, title, and YouTube's own abbreviated view-count text (e.g. \"13M views\"). `channel` takes a channel id, an @handle, or a channel URL, exactly as `listChannelVideos` does. A Short's own page carries no publish date and no length anywhere in the site's data — YouTube does not publish either for this tab, so neither field exists on the row. Pass back `continuation` alone — no `channel` needed — to read the next page; it is null once there are no more pages.\n\nCalls `bowmark.providers.youtube.listChannelShorts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeChannelShortPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"channel":{"type":"string"}},"required":["channel"],"additionalProperties":true},{"type":"object","properties":{"continuation":{"type":"string"}},"required":["continuation"],"additionalProperties":true}],"description":"TypeScript: `{ channel: string } | { continuation: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listChannelLiveStreams":{"post":{"operationId":"listChannelLiveStreams","summary":"A channel's Live tab, paged — upcoming, in-progress and past broadcasts, in the site's own order.","description":"A channel's Live tab, paged — upcoming, in-progress and past broadcasts, in the site's own order. Each row carries `status` (`\"upcoming\" | \"live\" | \"ended\"`): upcoming carries `watching` as a waiting-room count and `scheduledFor`; live carries `watching` as a concurrent viewer count; ended carries `views`, `published` (\"Streamed 1 day ago\") and `length`, the same fields `listChannelVideos` returns. `channel` takes a channel id, an @handle, or a channel URL, exactly as `listChannelVideos` does. A channel that has never streamed carries no Live tab at all — YouTube answers with its Home tab instead — which reads back as `{ streams: [], continuation: null }`, the same empty page a channel with a Live tab and zero streams on it would return. Pass back `continuation` alone — no `channel` needed — to read the next page; it is null once there are no more pages.\n\nCalls `bowmark.providers.youtube.listChannelLiveStreams`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeChannelLiveStreamPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"channel":{"type":"string"}},"required":["channel"],"additionalProperties":true},{"type":"object","properties":{"continuation":{"type":"string"}},"required":["continuation"],"additionalProperties":true}],"description":"TypeScript: `{ channel: string } | { continuation: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listChannelPlaylists":{"post":{"operationId":"listChannelPlaylists","summary":"The playlists a channel has published, in the site's own order and paged — each one's id, its `/playlist?list=<id>` url, title, YouTube's own badge text (\"197 videos\", or \"20 episodes\" for a podcast t","description":"The playlists a channel has published, in the site's own order and paged — each one's id, its `/playlist?list=<id>` url, title, YouTube's own badge text (\"197 videos\", or \"20 episodes\" for a podcast the channel runs, which lives on this same tab), and its \"Updated …\" stat with the prefix stripped (\"today\", \"5 days ago\") — null when a playlist carries no update stat at all. `channel` takes a channel id, an @handle, or a channel URL, exactly as `listChannelVideos` does. The door from a channel to `getPlaylist` and `listPlaylistVideos`. Pass back `continuation` alone — no `channel` needed — to read the next page; it is null once there are no more pages.\n\nCalls `bowmark.providers.youtube.listChannelPlaylists`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeChannelPlaylistPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"channel":{"type":"string"}},"required":["channel"],"additionalProperties":true},{"type":"object","properties":{"continuation":{"type":"string"}},"required":["continuation"],"additionalProperties":true}],"description":"TypeScript: `{ channel: string } | { continuation: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listChannelPosts":{"post":{"operationId":"listChannelPosts","summary":"A channel's Community tab — the text, image and poll posts a creator writes between uploads, never appearing on any video tab.","description":"A channel's Community tab — the text, image and poll posts a creator writes between uploads, never appearing on any video tab. Each post carries its author, plain text, YouTube's own relative age (\"2 weeks ago\", \"(edited)\" appended on an edited post), abbreviated like and comment counts (\"407K\", \"6.7K\", without the words), and an `attachment` of one of three kinds — `{ kind: \"image\", images }` (one or several), `{ kind: \"poll\", choices }` (choice text only, no vote counts — hidden from a logged-out viewer), `{ kind: \"video\", videoId, title }` (a video the channel shared into the tab, which can belong to another channel entirely) — or `null` for a text-only post. `channel` takes a channel id, an @handle, or a channel URL, exactly as `listChannelVideos` does. Pass back `continuation` alone — no `channel` needed — to read the next page; it is null once there are no more pages.\n\nCalls `bowmark.providers.youtube.listChannelPosts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeChannelPostPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"channel":{"type":"string"}},"required":["channel"],"additionalProperties":true},{"type":"object","properties":{"continuation":{"type":"string"}},"required":["continuation"],"additionalProperties":true}],"description":"TypeScript: `{ channel: string } | { continuation: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/searchWithinChannel":{"post":{"operationId":"searchWithinChannel","summary":"Search one channel's own videos rather than the whole site — the search box on a channel page.","description":"Search one channel's own videos rather than the whole site — the search box on a channel page. Returns the same video rows `search` does (id, url, title, channel, upload age, length, views), scoped to that channel and paged. `channel` takes a channel id, an @handle, or a channel URL, exactly as `listChannelVideos` does. A channel with no match at all answers a real, honest empty page rather than throwing. Pass back `continuation` alone — no `channel`/`query` needed — to read the next page; it is null once there are no more pages.\n\nCalls `bowmark.providers.youtube.searchWithinChannel`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeChannelSearchPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"channel":{"type":"string"},"query":{"type":"string"}},"required":["channel","query"],"additionalProperties":true},{"type":"object","properties":{"continuation":{"type":"string"}},"required":["continuation"],"additionalProperties":true}],"description":"TypeScript: `{ channel: string; query: string } | { continuation: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/getPlaylist":{"post":{"operationId":"getPlaylist","summary":"A playlist's own facts: title, description, the channel that owns it, exact video and view counts, and when it was last updated (an absolute date on an ordinary playlist, YouTube's own relative phrase","description":"A playlist's own facts: title, description, the channel that owns it, exact video and view counts, and when it was last updated (an absolute date on an ordinary playlist, YouTube's own relative phrase like \"5 days ago\" on a channel's auto-generated Uploads playlist). `playlist` is a playlist id or any playlist/watch URL carrying a `list` param — including a channel's Uploads playlist, whose id is always `\"UU\" + channelId.slice(2)`.\n\nCalls `bowmark.providers.youtube.getPlaylist`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubePlaylist>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"playlist":{"type":"string"}},"required":["playlist"],"additionalProperties":true,"description":"TypeScript: `{ playlist: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listPlaylistVideos":{"post":{"operationId":"listPlaylistVideos","summary":"The videos inside a playlist, in the playlist's own order and paged — each video's id, url, title, the channel that PUBLISHED it (not necessarily the playlist owner), YouTube's own abbreviated view-co","description":"The videos inside a playlist, in the playlist's own order and paged — each video's id, url, title, the channel that PUBLISHED it (not necessarily the playlist owner), YouTube's own abbreviated view-count text, upload age, length and thumbnail. `playlist` takes the same id or URL `getPlaylist` does, including a channel's Uploads playlist (`\"UU\" + channelId.slice(2)`). Pass back `continuation` alone — no `playlist` needed — to read the next page; it is null once there are no more pages.\n\nCalls `bowmark.providers.youtube.listPlaylistVideos`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubePlaylistVideoPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"anyOf":[{"type":"object","properties":{"playlist":{"type":"string"}},"required":["playlist"],"additionalProperties":true},{"type":"object","properties":{"continuation":{"type":"string"}},"required":["continuation"],"additionalProperties":true}],"description":"TypeScript: `{ playlist: string } | { continuation: string }`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listHomeFeed":{"post":{"operationId":"listHomeFeed","summary":"The videos on the signed-in account's own YouTube home page — the personalized recommendation grid, in YouTube's own order, which is what that account actually sees on youtube.com right now.","description":"The videos on the signed-in account's own YouTube home page — the personalized recommendation grid, in YouTube's own order, which is what that account actually sees on youtube.com right now. NEEDS A SIGN-IN and exists nowhere else: it is not in the public Data API, and logged out the same request answers 200 with an EMPTY grid rather than an error. Call `bowmark.video_library.homeFeed` rather than this directly.\n\nCalls `bowmark.providers.youtube.listHomeFeed`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeSearchVideo[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: 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/youtube/listWatchLater":{"post":{"operationId":"listWatchLater","summary":"The signed-in account's Watch Later queue, newest first, paged like any playlist; `limit` keeps only the first N rows of the first page and never reads further — pass `continuation` for more.","description":"The signed-in account's Watch Later queue, newest first, paged like any playlist; `limit` keeps only the first N rows of the first page and never reads further — pass `continuation` for more. NEEDS A SIGN-IN, and a grant is issued to a capability — call `bowmark.video_library.watchLater` rather than this directly. Not reachable through YouTube's public Data API at all: Google removed access to the `WL` list in 2016.\n\nCalls `bowmark.providers.youtube.listWatchLater`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubePlaylistVideoPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"continuation":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ continuation?: string; limit?: 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/youtube/listLikedVideos":{"post":{"operationId":"listLikedVideos","summary":"The videos the signed-in account has liked, newest first, paged like any playlist; `limit` keeps only the first N rows of the first page and never reads further — pass `continuation` for more.","description":"The videos the signed-in account has liked, newest first, paged like any playlist; `limit` keeps only the first N rows of the first page and never reads further — pass `continuation` for more. NEEDS A SIGN-IN — call `bowmark.video_library.liked` rather than this directly.\n\nCalls `bowmark.providers.youtube.listLikedVideos`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubePlaylistVideoPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"continuation":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ continuation?: string; limit?: 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/youtube/listWatchHistory":{"post":{"operationId":"listWatchHistory","summary":"What the signed-in account has watched, newest first, paged like any playlist, each row with `percentWatched` (0-100, 100 = watched to the end) when YouTube draws its progress bar.","description":"What the signed-in account has watched, newest first, paged like any playlist, each row with `percentWatched` (0-100, 100 = watched to the end) when YouTube draws its progress bar. NEEDS A SIGN-IN — `bowmark.video_library.history()` is the capability over it. Per-account and starts empty.\n\nCalls `bowmark.providers.youtube.listWatchHistory`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubePlaylistVideoPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"continuation":{"type":"string"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ continuation?: string; limit?: 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/youtube/createPlaylist":{"post":{"operationId":"createPlaylist","summary":"Creates an EMPTY playlist on the signed-in account and returns its id and URL.","description":"Creates an EMPTY playlist on the signed-in account and returns its id and URL. `privacy` defaults to \"private\". NOT idempotent — YouTube allows duplicate titles, so calling twice makes two playlists. Title it for the PERSON whose account it lands on: the subject in their own words, never a tool name, run id or timestamp, and set `description` to what the videos have in common. NEEDS A SIGN-IN — call `bowmark.video_library.createPlaylist` rather than this directly.\n\nCalls `bowmark.providers.youtube.createPlaylist`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeCreatedPlaylist>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"privacy":{"anyOf":[{"const":"private"},{"const":"unlisted"},{"const":"public"}]}},"required":["title"],"additionalProperties":true,"description":"TypeScript: `{ title: string; description?: string; privacy?: \"private\" | \"unlisted\" | \"public\" }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/createChannel":{"post":{"operationId":"createChannel","summary":"Creates the signed-in Google account's YouTube CHANNEL, using the account's own name and profile photo — the only thing YouTube's own dialog offers on this path.","description":"Creates the signed-in Google account's YouTube CHANNEL, using the account's own name and profile photo — the only thing YouTube's own dialog offers on this path. Most Google accounts have never had one, and without one YouTube refuses to make a public or unlisted playlist (a private one works, because that belongs to the account rather than to a channel). THIS ACCEPTS YOUTUBE'S TERMS OF SERVICE on the account holder's behalf, which is what their own Create channel button does, so do not call it to work around an error — call it because the person whose account it is asked for a channel. Idempotent: an account that already has one gets `alreadyExisted: true` and nothing is created. NEEDS A SIGN-IN.\n\nCalls `bowmark.providers.youtube.createChannel`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeCreatedChannel>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/addToPlaylist":{"post":{"operationId":"addToPlaylist","summary":"Adds one or many videos to one of the signed-in account's own playlists, as a SINGLE edit rather than one request per video.","description":"Adds one or many videos to one of the signed-in account's own playlists, as a SINGLE edit rather than one request per video. Order is preserved: the videos appear in the order they were sent, measured 2026-09-18. A playlist READ BACK IN THE SAME RUN can still come back empty — the write is applied but YouTube indexes it a beat later, measured at ~2s — so do not treat an immediate empty read as a failed add. YouTube permits duplicates, so adding a video already present adds it again. NEEDS A SIGN-IN — call `bowmark.video_library.addToPlaylist` rather than this directly.\n\nCalls `bowmark.providers.youtube.addToPlaylist`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubePlaylistEdit>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"playlist":{"type":"string"},"video":{"type":"string"},"videos":{"type":"array","items":{"type":"string"}}},"required":["playlist"],"additionalProperties":true,"description":"TypeScript: `{ playlist: string; video?: string; videos?: string[] }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/removeFromPlaylist":{"post":{"operationId":"removeFromPlaylist","summary":"Removes one or many videos from one of the signed-in account's own playlists, as a SINGLE edit rather than one request per video.","description":"Removes one or many videos from one of the signed-in account's own playlists, as a SINGLE edit rather than one request per video. Works on Watch Later too: its playlist id is WL. A video not on the playlist is silently a no-op for that video — YouTube's own edit endpoint does not distinguish it from a successful removal. NEEDS A SIGN-IN.\n\nCalls `bowmark.providers.youtube.removeFromPlaylist`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubePlaylistEdit>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"playlist":{"type":"string"},"video":{"type":"string"},"videos":{"type":"array","items":{"type":"string"}}},"required":["playlist"],"additionalProperties":true,"description":"TypeScript: `{ playlist: string; video?: string; videos?: string[] }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/updatePlaylist":{"post":{"operationId":"updatePlaylist","summary":"Changes the title, description, or privacy setting of one of the signed-in account's own playlists.","description":"Changes the title, description, or privacy setting of one of the signed-in account's own playlists. `playlist` is a playlist id (`PL…`), a `VL<id>` playlist URL, or a full URL. Pass any combination of `title`, `description` (a new description to replace the old one, max 5000 chars), or `privacy` (`PUBLIC`, `PRIVATE`, or `UNLISTED`). NEEDS A SIGN-IN.\n\nCalls `bowmark.providers.youtube.updatePlaylist`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubePlaylistEdit>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"playlist":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"privacy":{"type":"string"}},"required":["playlist"],"additionalProperties":true,"description":"TypeScript: `{ playlist: string; title?: string; description?: string; privacy?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/deletePlaylist":{"post":{"operationId":"deletePlaylist","summary":"PERMANENTLY deletes one of the signed-in account's own playlists — YouTube offers no undo.","description":"PERMANENTLY deletes one of the signed-in account's own playlists — YouTube offers no undo. `playlist` is a playlist id (`PL…`), a `VL<id>` playlist URL, or a full URL. Only call it when the account holder asked for that playlist to be deleted. NEEDS A SIGN-IN.\n\nCalls `bowmark.providers.youtube.deletePlaylist`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeDeletedPlaylist>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"playlist":{"type":"string"}},"required":["playlist"],"additionalProperties":true,"description":"TypeScript: `{ playlist: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listSubscriptions":{"post":{"operationId":"listSubscriptions","summary":"The channels the signed-in account subscribes to — id, url, handle (when the row carries one), title, subscriber count text and thumbnail, off YouTube's own Manage subscriptions page (`browse` on `bro","description":"The channels the signed-in account subscribes to — id, url, handle (when the row carries one), title, subscriber count text and thumbnail, off YouTube's own Manage subscriptions page (`browse` on `browseId: \"FEchannels\"`). An empty page is double-checked against the guide sidebar: `[]` only when the guide also lists no subscriptions, otherwise an error, never a silent zero. NEEDS A SIGN-IN and exists nowhere else logged out. NOT paged — declared this way because the unsigned reach could not measure whether a very large subscription list continues, and no continuation renderer has been observed on this door yet.\n\nCalls `bowmark.providers.youtube.listSubscriptions`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeChannelRef[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/subscribeToChannel":{"post":{"operationId":"subscribeToChannel","summary":"Subscribe the signed-in account to a channel (`subscribe: true`, the default) or unsubscribe from it (`subscribe: false`).","description":"Subscribe the signed-in account to a channel (`subscribe: true`, the default) or unsubscribe from it (`subscribe: false`). It does NOT toggle: calling it twice leaves you subscribed. `channel` is a channel id (`UC…`), an `@handle`, or a channel URL — a handle or URL is resolved to its id first; a plain name is refused, so resolve one with `findChannel`. Returns the channel id and the state YouTube accepted. NEEDS A SIGN-IN and exists nowhere else logged out.\n\nCalls `bowmark.providers.youtube.subscribeToChannel`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ channel: string; subscribed: boolean }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"channel":{"type":"string"},"subscribe":{"type":"boolean"}},"required":["channel"],"additionalProperties":true,"description":"TypeScript: `{ channel: string; subscribe?: boolean }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/likeVideo":{"post":{"operationId":"likeVideo","summary":"Sets the signed-in account's rating on a video: \"like\", \"dislike\", or \"none\" to clear whatever rating is there.","description":"Sets the signed-in account's rating on a video: \"like\", \"dislike\", or \"none\" to clear whatever rating is there. `video` is a bare 11-character video id or any watch/shorts/youtu.be URL. All three ride the same call — YouTube's own three separate endpoints (`like/like`, `like/dislike`, `like/removelike`) collapse to one argument rather than three functions, because a caller who wants \"no rating\" and a caller who wants a fresh dislike are both just naming the end state they want. NEEDS A SIGN-IN and exists nowhere else logged out.\n\nCalls `bowmark.providers.youtube.likeVideo`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ video: string; rating: \"like\" | \"dislike\" | \"none\" }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"},"rating":{"anyOf":[{"const":"like"},{"const":"dislike"},{"const":"none"}]}},"required":["video","rating"],"additionalProperties":true,"description":"TypeScript: `{ video: string; rating: \"like\" | \"dislike\" | \"none\" }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/postComment":{"post":{"operationId":"postComment","summary":"Posts a top-level comment on a video as the signed-in account — a PUBLIC write on somebody else's video, visible to anyone who opens it.","description":"Posts a top-level comment on a video as the signed-in account — a PUBLIC write on somebody else's video, visible to anyone who opens it. `video` is a bare 11-character video id or any watch/shorts/youtu.be URL; `text` is the comment body. Walks the same comments panel `listComments` reads to find the viewer's own \"Add a comment\" box and its one-time `createCommentParams` token, then posts through it — a logged-out viewer's box carries a sign-in prompt instead and no token at all (measured 2026-10-04), which is what this refuses on before any write is attempted. `commentId` is null: YouTube's create-comment response shape has not been captured against a real posted comment yet, so this does not invent one. NEEDS A SIGN-IN and exists nowhere else logged out.\n\nCalls `bowmark.providers.youtube.postComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ video: string; commentId: string | null; text: string }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"},"text":{"type":"string"}},"required":["video","text"],"additionalProperties":true,"description":"TypeScript: `{ video: string; text: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/replyToComment":{"post":{"operationId":"replyToComment","summary":"Replies to an existing top-level comment on a video as the signed-in account — same public-write shape as `postComment`, on a thread instead of the video.","description":"Replies to an existing top-level comment on a video as the signed-in account — same public-write shape as `postComment`, on a thread instead of the video. `video` is a bare 11-character video id or any watch/shorts/youtu.be URL; `commentId` is the id a comment carries off `listComments`/`listCommentReplies`; `text` is the reply body. Walks the same comments panel, searching up to 10 pages for the target comment, then reads its reply-compose token and posts through it — refuses up front with nobody signed in, before any page is even fetched. `commentId` on the result is null, the same unmeasured create-response gap `postComment` has. NEEDS A SIGN-IN and exists nowhere else logged out.\n\nCalls `bowmark.providers.youtube.replyToComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ video: string; repliedTo: string; commentId: string | null; text: string }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"},"commentId":{"type":"string"},"text":{"type":"string"}},"required":["video","commentId","text"],"additionalProperties":true,"description":"TypeScript: `{ video: string; commentId: string; text: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/deleteComment":{"post":{"operationId":"deleteComment","summary":"Deletes a top-level comment the signed-in account wrote — the undo for `postComment` (replies are not supported yet).","description":"Deletes a top-level comment the signed-in account wrote — the undo for `postComment` (replies are not supported yet). `video` is a bare 11-character video id or any watch/shorts/youtu.be URL; `commentId` is the id `listComments` returned for it. Walks the same comments panel as `replyToComment`, searching up to 10 pages for the comment's own delete option on its action menu, then posts through it — refuses up front with nobody signed in, before any page is even fetched. NEEDS A SIGN-IN and exists nowhere else logged out.\n\nCalls `bowmark.providers.youtube.deleteComment`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ video: string; commentId: string; deleted: boolean }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"},"commentId":{"type":"string"}},"required":["video","commentId"],"additionalProperties":true,"description":"TypeScript: `{ video: string; commentId: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/listMyVideos":{"post":{"operationId":"listMyVideos","summary":"The videos on the signed-in account's OWN channel, newest first, as YouTube Studio lists them — private and unlisted ones included, each with its privacy and processing status.","description":"The videos on the signed-in account's OWN channel, newest first, as YouTube Studio lists them — private and unlisted ones included, each with its privacy and processing status. `limit` is 1-100 (default 30); pass `nextPageToken` back as `pageToken` for more. NEEDS A SIGN-IN — call `bowmark.video_library.myVideos` rather than this directly.\n\nCalls `bowmark.providers.youtube.listMyVideos`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeMyVideoPage>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"limit":{"type":"number"},"pageToken":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `{ limit?: number; pageToken?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/uploadVideo":{"post":{"operationId":"uploadVideo","summary":"Uploads a video file to the signed-in account's own channel.","description":"Uploads a video file to the signed-in account's own channel. Pass exactly one of `file` (a Bowmark file id — the bytes stream from the account's storage and never pass through your script) or `url` (an https link that reports its size). `privacy` defaults to \"private\"; a \"public\" upload is visible to everyone at once under the account holder's name, so only publish when they asked. Returns as soon as YouTube accepts the file, with `status: \"processing\"` — encoding takes minutes. Resumes a dropped transfer from where it stopped. Measured 2026-09-24: a small file took ~12s end to end, most of it opening YouTube Studio once to get the upload token. The whole upload has to finish inside the run's deadline, so very large files will not fit. To trim, cut or blur the footage afterwards, `bowmark.video_editing.editFootage` hands YouTube Studio's editor to a browser agent. NEEDS A SIGN-IN — call `bowmark.video_library.uploadVideo` rather than this directly.\n\nCalls `bowmark.providers.youtube.uploadVideo`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeUploadedVideo>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"file":{"type":"string"},"url":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"categoryId":{"type":"number"},"privacy":{"anyOf":[{"const":"private"},{"const":"unlisted"},{"const":"public"}]}},"required":["title"],"additionalProperties":true,"description":"TypeScript: `{ file?: string; url?: string; title: string; description?: string; tags?: string[]; categoryId?: number; privacy?: \"private\" | \"unlisted\" | \"public\" }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/updateVideo":{"post":{"operationId":"updateVideo","summary":"Changes the details of one of the signed-in account's own videos: title, description, tags (REPLACES the whole list), category (YouTube's numeric id, e.g.","description":"Changes the details of one of the signed-in account's own videos: title, description, tags (REPLACES the whole list), category (YouTube's numeric id, e.g. 22 People & Blogs, 27 Education, 28 Science & Technology) and privacy. Send only the fields to change. Returns the fields YouTube confirmed plus the video as read back afterwards; if YouTube accepts some fields and refuses others it throws and says which ones ARE live. Details only — YouTube does not cut or re-encode footage here. NEEDS A SIGN-IN — call `bowmark.video_library.updateVideo` rather than this directly.\n\nCalls `bowmark.providers.youtube.updateVideo`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeVideoEdit>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"categoryId":{"type":"number"},"privacy":{"anyOf":[{"const":"private"},{"const":"unlisted"},{"const":"public"}]}},"required":["video"],"additionalProperties":true,"description":"TypeScript: `{ video: string; title?: string; description?: string; tags?: string[]; categoryId?: number; privacy?: \"private\" | \"unlisted\" | \"public\" }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/setThumbnail":{"post":{"operationId":"setThumbnail","summary":"Sets a custom thumbnail (JPG or PNG, up to 2 MB, 1280x720 recommended) on one of the signed-in account's own videos, from a Bowmark file id or an https URL.","description":"Sets a custom thumbnail (JPG or PNG, up to 2 MB, 1280x720 recommended) on one of the signed-in account's own videos, from a Bowmark file id or an https URL. YouTube only allows custom thumbnails on a channel verified with a phone number; on one that is not, this refuses up front and says so (measured 2026-09-24). The success path has not been measured on a verified channel yet. NEEDS A SIGN-IN — call `bowmark.video_library.setThumbnail` rather than this directly.\n\nCalls `bowmark.providers.youtube.setThumbnail`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeThumbnailSet>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"},"file":{"type":"string"},"url":{"type":"string"}},"required":["video"],"additionalProperties":true,"description":"TypeScript: `{ video: string; file?: string; url?: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/deleteVideo":{"post":{"operationId":"deleteVideo","summary":"PERMANENTLY deletes one of the signed-in account's own videos — views, comments and all; YouTube offers no undo.","description":"PERMANENTLY deletes one of the signed-in account's own videos — views, comments and all; YouTube offers no undo. Checks first that the video is on this account's channel and refuses anything else. Only call it when the account holder asked for that video to be deleted. NEEDS A SIGN-IN — call `bowmark.video_library.deleteVideo` rather than this directly.\n\nCalls `bowmark.providers.youtube.deleteVideo`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<YoutubeDeletedVideo>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"video":{"type":"string"}},"required":["video"],"additionalProperties":true,"description":"TypeScript: `{ video: string }`"},"opts":{"type":"object","properties":{"connection":{"type":"string"}},"required":["connection"],"additionalProperties":true,"description":"TypeScript: `ConnectionOption`"}},"required":["input"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/youtube/login":{"post":{"operationId":"login","summary":"Signs in with the given credentials and saves a NEW connection — every call creates one, never replacing an existing login, unless `connection` names an existing id to sign back in to (its cookies rep","description":"Signs in with the given credentials and saves a NEW connection — every call creates one, never replacing an existing login, unless `connection` names an existing id to sign back in to (its cookies replaced, its id and settings kept, a logged-out one revived). The returned `connection` is usable on the very next call in the same script or session. `warnings` names the account's other connections to this site. `username`, `password`, `totpCode` and `totpSeed` are plain values here; a caller on the run/session script surface instead passes each as a `bowmark.secret()` reference. Pass the returned `connection` id as `{ connection }` on a later signed-in call to act as this account. Optionally set `keepAlive: { everyHours }` (or `false` to turn it off) and/or `expiresAt` (an ISO date/datetime, a hard ceiling); both default to a 12-hour keep-alive and can be changed later with `bm.connections.update(id, …)`.\n\nCalls `bowmark.providers.youtube.login`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<{ connection: string; account: string; expiresAt: string; warnings?: string[] }>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"creds":{"type":"object","properties":{"username":{"type":"string"},"password":{"type":"string"},"totpCode":{"type":"string"},"totpSeed":{"type":"string"},"keepAlive":{"anyOf":[{"type":"object","properties":{"everyHours":{"type":"number"}},"required":["everyHours"],"additionalProperties":true},{"const":false}]},"expiresAt":{"type":"string"},"connection":{"type":"string"}},"additionalProperties":true,"description":"TypeScript: `LoginInput`"}},"required":["creds"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}}},"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}}}}}}