Documentation

// Ingest a video that already exists in your source
const result = await client.ingest({
  key: 'recordings/standup.mp4',
  callbackUrl: 'https://example.com/webhook'
})

console.log(result.videoKey)
// → "recordings-standup"

console.log(result.transcodeStatus)
// → "pending"

// Get a presigned URL (uploads to xform, not your source)
const { uploadUrl, key } = await client.createUploadUrl({
  filename: 'intro.mp4',
  contentType: 'video/mp4'
})

// Upload directly from the browser to xform
await fetch(uploadUrl, {
  method: 'PUT',
  body: videoFile,
  headers: { 'Content-Type': 'video/mp4' }
})

// Then trigger transcoding
const result = await client.ingest({ key })

const iframe = client.embed('intro', {
  autoplay: false,
  muted: false,
  controls: true,
  quality: 'auto',
  captions: true,
  search: true,
  color: '6366f1',
  title: 'Product Introduction'
})

{
  "event": "video.ready",
  "sourceId": "src_...",
  "videoKey": "intro",
  "timestamp": "2026-03-16T10:30:00Z",
  "data": {
    "streamUrl": "/_v/intro.m3u8",
    "downloadUrl": "/_v/intro.mp4",
    "thumbnailUrl": "/_v/intro/thumbnail.jpg",
    "duration": 124.5,
    "width": 1920,
    "height": 1080
  }
}

// Summary analytics
const summary = await client.videos.analytics()
console.log(summary.totalViews)
console.log(summary.avgCompletionRate)

// Detailed breakdown for a specific video
const detailed = await client.videos.analytics({
  videoKey: 'intro',
  detailed: true,
  since: '2026-03-01',
  until: '2026-03-16'
})

// List all videos
const { data } = await client.videos.list()

// Get a specific video
const video = await client.videos.get('intro')

// Upload captions
await client.videos.uploadCaptions(
  'intro',
  'WEBVTT\n\n00:00.000 --> 00:05.000\nHello!'
)

// Delete a video
await client.videos.delete(video.id)