Video library
GET /v1/videos: the shared videos a workspace holds, with their page text, watch links and timed transcript lines.
Not available yet
The video library is not available on the API yet. These endpoints answer 501 feature_unavailable for now.
A workspace's video library holds the videos it has shared, each with a reusable watch link and the text of its watch page: a title, a one-line subject, a summary, key points and chapters. Both routes are read-only.
In an MCP client, list_video_library returns the list and get_video_text returns one video with its transcript.
Both routes need the account owner's own live key. A sandbox key or a teammate's key answers 403 library_permission_required. An account whose video library is not switched on answers 403 library_not_enabled.
List videos
GET https://api.bluereacher.com/v1/videosReturns the videos the workspace holds that are ready, unlisted and not deleted. Up to 100 are listed; limited is true when the library holds more. The list carries no transcript text.
curl https://api.bluereacher.com/v1/videos \
-H "Authorization: Bearer brk_your_api_key"{
"success": true,
"videos": [
{
"id": "3f1c9a7e-5b2d-4c8e-9a1f-7d6e2b4c8a90",
"object": "video",
"title": "Onboarding walkthrough",
"subject": "How a new client sets up their first line",
"summary": "A ten minute tour of the setup screens.",
"key_points": ["Pick a line", "Register a webhook"],
"chapters": [{ "start_ms": 0, "title": "Welcome" }],
"revision": "9b4e2d1c-0a7f-4e3b-8c6d-5f2a1b9e7d30",
"url": "https://example.com/watch/3f1c9a7e",
"duration_ms": 612000,
"width": 1920,
"height": 1080,
"created_at": "2026-10-08T15:20:11Z",
"can_edit": true
}
],
"limited": false
}| Field | Meaning |
|---|---|
title | The watch page title, up to 160 characters |
subject | What the video is about, one line, up to 200 characters |
summary | The watch page summary, up to 4,000 characters |
key_points | Short lines a viewer can skim, up to 300 characters each |
chapters | start_ms and title per chapter, so a viewer can jump to it |
revision | The current revision of the page text; null until the page was written |
url | The reusable watch link |
duration_ms, width, height | Length in milliseconds and the frame size |
can_edit | true for the key owner's own Blue Reacher videos |
Read one video
GET https://api.bluereacher.com/v1/videos/{video_id}Returns one video with the same fields as the list, plus transcript_status and transcript. Use an id from the list. A video outside the workspace's library answers 404 video_not_found.
curl https://api.bluereacher.com/v1/videos/3f1c9a7e-5b2d-4c8e-9a1f-7d6e2b4c8a90 \
-H "Authorization: Bearer brk_your_api_key"{
"success": true,
"video": {
"id": "3f1c9a7e-5b2d-4c8e-9a1f-7d6e2b4c8a90",
"object": "video",
"title": "Onboarding walkthrough",
"transcript_status": "ready",
"transcript": {
"locale": "en-US",
"cues": [
{ "start_ms": 0, "end_ms": 2400, "text": "Welcome to the setup tour." }
]
}
}
}| Field | Meaning |
|---|---|
transcript_status | ready when the transcript exists; otherwise pending, unavailable, failed or none (no captions were requested) |
transcript | null until transcript_status is ready |
transcript.locale | BCP 47 tag of the captions, or empty |
transcript.cues | Timed lines, each with start_ms, end_ms and text |
Errors
| Status | Code | Meaning |
|---|---|---|
| 403 | library_permission_required | The key is not the account owner's own live key |
| 403 | library_not_enabled | The account's video library is not switched on |
| 404 | video_not_found | No video with that id in this workspace's library |
Calls
FaceTime audio calls from your lines, always confirmed by a person: list calling lines, prepare a call, follow its lifecycle, end or decline it, hand it to a teammate, switch recording and transcripts, and read call history.
Campaigns and sequencing
How sequencing works over the API: campaigns are a platform feature, and API-driven sequences are built from drip sends plus webhooks.