API Reference

Recording

Access interview session recordings stored in cloud storage.

Interview sessions are recorded as WebM video chunks and stored in cloud storage. The Recording API provides access to individual chunks and a combined stream for playback in the admin dashboard.

Endpoints

Method	Endpoint	Auth	Description
GET	/recording/:sessionId/chunks	JWT	List all recording chunks for a session
GET	/recording/:sessionId/stream	JWT	Stream the full recording as a single file

GET /recording/:sessionId/chunks - List Chunks

Returns metadata for all recorded chunks in chronological order. Each chunk represents a segment of the interview video.

bash

curl https://mayaapi.teamcast.ai/api/v1/recording/<session-id>/chunks \
  -H "Authorization: Bearer <jwt>"

json

{
  "sessionId": "session_...",
  "chunks": [
    {
      "timestamp": 1704067200000,
      "path": "recordings/<tenant-id>/<session-id>/1704067200000.webm",
      "sizeBytes": 384000,
      "durationMs": 5000
    }
  ],
  "totalChunks": 24,
  "totalDurationMs": 120000
}

GET /recording/:sessionId/stream - Stream Recording

Returns the full interview recording as a combined stream. The response is a binary WebM file suitable for direct playback in a browser video element.

bash

curl https://mayaapi.teamcast.ai/api/v1/recording/<session-id>/stream \
  -H "Authorization: Bearer <jwt>" \
  -o recording.webm

The stream endpoint combines all chunks server-side. For large recordings, use the chunks endpoint and load segments on demand for faster initial playback.

Recording Format

Property	Value
Container	WebM
Video Codec	VP8 / VP9
Audio	Not included (audio is in the transcript)
Chunk Duration	~5 seconds
Storage	Google Cloud Storage

Was this page helpful?

Previous← Invitations

NextAdmin Monitoring →