Skip to main content
Media endpoints help applications turn transcript-backed audio or video into reviewable outputs. Use them to create captioned clips from vault media, retrieve transcript text, and search timestamped transcript words for clip assembly or evidence review.

Captioned clips

Generate short captioned video clips from source media and transcript word ranges.

Transcript utilities

Retrieve transcript text or search transcript words with timing metadata.

​
Create a clip

Shell
curl -X POST https://api.case.dev/media/v1/clips \
  -H "Authorization: Bearer $CASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "vault_id": "vault_abc123",
      "object_id": "obj_media123"
    },
    "transcript": {
      "object_id": "obj_transcript123"
    },
    "selection": {
      "type": "word_range",
      "start_word": 120,
      "end_word": 260
    }
  }'
Clip creation is asynchronous. The response returns a job ID that you can poll until the clip is complete.
Shell
curl "https://api.case.dev/media/v1/clips/{id}" \
  -H "Authorization: Bearer $CASE_API_KEY"

​
Work with transcripts

Use transcript retrieval when you need the full text for display, export, or downstream analysis.
Shell
curl -X POST https://api.case.dev/media/v1/transcripts/retrieve \
  -H "Authorization: Bearer $CASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vault_id": "vault_abc123",
    "object_id": "obj_media123"
  }'
Use transcript word search when you need exact word ranges and timing for clip selection.
Shell
curl -X POST https://api.case.dev/media/v1/transcripts/search \
  -H "Authorization: Bearer $CASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transcript": {
      "vault_id": "vault_abc123",
      "object_id": "obj_transcript123"
    },
    "query": "contract termination"
  }'
See the API Reference for full request and response schemas.