Recordings

POST /v2/projects/{projectId}/recordings

{
  "name": "User Interview - John Doe",
  "description": "Interview about checkout experience",
  "filename": "interview-john.mp4",
  "mimeType": "video/mp4",
  "fileSize": 104857600
}

{
  "recordingId": "507f1f77bcf86cd799439013",
  "uploadUrl": "https://storage.blob.core.windows.net/container/path?sv=2021-06-08&ss=b&srt=co&sp=rwdlacx&se=2024-12-26T14:00:00Z&st=2024-12-26T12:00:00Z&spr=https&sig=...",
  "blobPath": "orgId/projectId/recordingId/filename.mp4",
  "expiresAt": "2024-12-26T14:00:00.000Z",
  "maxFileSize": 419430400
}

curl -X POST "https://api.yeino.com/v2/projects/507f1f77bcf86cd799439011/recordings" \
  -H "x-api-key: yno_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "User Interview - John Doe",
    "filename": "interview-john.mp4",
    "mimeType": "video/mp4",
    "fileSize": 104857600
  }'

{
  "statusCode": 400,
  "message": "File size exceeds maximum allowed size of 419430400 bytes.",
  "error": "Bad Request"
}

curl -X PUT "{uploadUrl}" \
  -H "x-ms-blob-type: BlockBlob" \
  -H "Content-Type: video/mp4" \
  --data-binary @interview-john.mp4

POST /v2/recordings/{recordingId}/complete

{}

{
  "actualFileSize": 104857600
}

{
  "id": "507f1f77bcf86cd799439013",
  "name": "User Interview - John Doe",
  "status": "processing",
  "isUploaded": true,
  "createdAt": "2024-12-26T10:30:00.000Z"
}

curl -X POST "https://api.yeino.com/v2/recordings/507f1f77bcf86cd799439013/complete" \
  -H "x-api-key: yno_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{}'

GET /v2/recordings/{recordingId}

{
  "id": "507f1f77bcf86cd799439013",
  "name": "User Interview - John Doe",
  "description": "Interview about checkout experience",
  "status": "completed",
  "isUploaded": true,
  "fileType": "video",
  "originalFilename": "interview-john.mp4",
  "mimeType": "video/mp4",
  "fileSize": 104857600,
  "fileMetadata": {
    "duration": 1847.5,
    "language": "en",
    "speakerCount": 2,
    "wordCount": 4523
  },
  "transcriptSummary": {
    "summary": "John discussed his frustrations with the current checkout process...",
    "keyTopics": ["checkout flow", "payment options", "error messages"],
    "participants": ["Interviewer", "John Doe"]
  },
  "fullTranscript": "Welcome John. Thanks for joining us today...",
  "transcript": [
    {
      "speaker": "Speaker 1",
      "startTime": 0.5,
      "endTime": 5.2,
      "text": "Welcome John. Thanks for joining us today."
    },
    {
      "speaker": "Speaker 2",
      "startTime": 5.8,
      "endTime": 9.1,
      "text": "Thanks for having me. Happy to help."
    }
  ],
  "createdAt": "2024-12-26T10:30:00.000Z",
  "processedAt": "2024-12-26T10:45:00.000Z"
}

curl -X GET "https://api.yeino.com/v2/recordings/507f1f77bcf86cd799439013" \
  -H "x-api-key: yno_live_abc123..."

GET /v2/recordings/{recordingId}/status

{
  "id": "507f1f77bcf86cd799439013",
  "name": "User Interview - John Doe",
  "status": "processing",
  "isUploaded": true,
  "createdAt": "2024-12-26T10:30:00.000Z"
}

curl -X GET "https://api.yeino.com/v2/recordings/507f1f77bcf86cd799439013/status" \
  -H "x-api-key: yno_live_abc123..."

// 1. Initiate upload
const initResponse = await fetch('/v2/projects/{projectId}/recordings', {
  method: 'POST',
  headers: {
    'x-api-key': 'yno_live_abc123...',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'User Interview - John Doe',
    filename: 'interview.mp4',
    mimeType: 'video/mp4',
    fileSize: file.size,
  }),
});
const { recordingId, uploadUrl } = await initResponse.json();
 
// 2. Upload file to Azure
await fetch(uploadUrl, {
  method: 'PUT',
  headers: {
    'x-ms-blob-type': 'BlockBlob',
    'Content-Type': 'video/mp4',
  },
  body: file,
});
 
// 3. Complete upload
await fetch(`/v2/recordings/${recordingId}/complete`, {
  method: 'POST',
  headers: {
    'x-api-key': 'yno_live_abc123...',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});
 
// 4. Poll for completion
let status = 'processing';
while (status === 'processing' || status === 'pending') {
  await new Promise(resolve => setTimeout(resolve, 5000)); // Wait 5 seconds
  
  const statusResponse = await fetch(`/v2/recordings/${recordingId}/status`, {
    headers: { 'x-api-key': 'yno_live_abc123...' },
  });
  const { status: currentStatus } = await statusResponse.json();
  status = currentStatus;
}
 
// 5. Get full recording with transcript
const recording = await fetch(`/v2/recordings/${recordingId}`, {
  headers: { 'x-api-key': 'yno_live_abc123...' },
}).then(r => r.json());
 
console.log(recording.transcriptSummary);
console.log(recording.transcript);