MeetStream Guide: Pause & Resume Recording

Temporarily pause a bot’s recording during a live meeting, then resume it — without removing the bot or interrupting the meeting. Useful for keeping sensitive segments (a private aside, a break, confidential figures) out of the saved recording and transcript.

How it works

While a bot is in a meeting it is continuously recording. When you send a pause request, the bot keeps sitting in the meeting but its capture goes blank:

• Video becomes a black screen.
• Audio becomes silent.

When you send resume, normal recording continues.

The recording’s total length is unchanged — a paused stretch appears as black video and silent audio of exactly the same duration, so timestamps before and after the pause stay accurate and audio/video remain in sync.

What a pause affects

The bot remains visibly present in the meeting the whole time — only what it records and streams goes blank.

Prerequisites

• A bot that is currently in the meeting and recording (status: InMeeting). A bot that is still joining or sitting in the waiting room cannot be paused — wait until it has been admitted.
• Your MeetStream API key.
• Available on Google Meet.

Endpoints

POST https://api.meetstream.ai/api/v1/bots/{bot_id}/pause_recording
POST https://api.meetstream.ai/api/v1/bots/{bot_id}/resume_recording

No request body is required.

Example: Pause recording

$
curl -X POST "https://api.meetstream.ai/api/v1/bots/{bot_id}/pause_recording" \
>
  -H "Authorization: Token <YOUR_API_KEY>"

Response (200)

1
{
2
  "status": "accepted",
3
  "bot_id": "83acdd72-3257-4b06-a2e9-0d879dc571ff",
4
  "command": "pause_recording"
5
}

Example: Resume recording

$
curl -X POST "https://api.meetstream.ai/api/v1/bots/{bot_id}/resume_recording" \
>
  -H "Authorization: Token <YOUR_API_KEY>"

Response (200)

1
{
2
  "status": "accepted",
3
  "bot_id": "83acdd72-3257-4b06-a2e9-0d879dc571ff",
4
  "command": "resume_recording"
5
}

Behavior notes

• Timeline is preserved. Pausing does not shorten or cut the recording — the paused window stays in the file as black video + silent audio of the same duration. The final recording is the full real-world length of the meeting.
• Idempotent. Sending pause to an already-paused bot (or resume to a running bot) is accepted and has no additional effect.
• You can pause and resume as many times as you like during a single meeting.
• Resume is sharp. Video returns to a clean picture immediately after you resume.
• A bot that is not yet recording (still joining / in the waiting room) cannot be paused — wait until it has been admitted and is recording.

Conditions

• The bot must be in the meeting (InMeeting status). Requests sent while the bot is still joining / in the waiting room, or after it has left, return a 409 error.
• Rate limit: 30 requests per minute per bot.

Error Responses