Manage Recordings

These endpoints allow you to manage the recordings you have uploaded to Call Intel.

List Recordings

Retrieve a paginated list of recordings within a specific use case.

Endpoint POST {{baseUrl}}/v1alpha/callintel/org-usecases/recordings

Request Body

Code
 
{
  "page": 1,
  "limit": 10,
  "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
  "status": "COMPLETED", 
  "search_term": "sales call" 
}

Response Example

Code
 
{
  "data": [
    {
      "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456",
      "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
      "file_name": "sales-call-001.wav",
      "processing_state": "COMPLETED",
      "is_active": true,
      "created_at": "2025-12-04T03:31:49.152Z",
      "updated_at": "2025-12-04T03:31:49.152Z",
      "recording_object_key": "18412186-59e9/de112ad9/recordings/8838213763.mp3",
      "disposition": "Follow-up Required",
      "tags": [],
      "overall_sentiment": "",
      "overall_score": null,
      "duration_seconds": 179
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10,
  "total_pages": 1
}

Note: status and search_term are optional filters.

Get Recording Analysis Details

Fetch the metadata and status details for a specific recording.

Endpoint POST {{baseUrl}}/v1alpha/callintel/org-usecases/get-recording-details

Request Body

Code
 
{
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
  "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
}

Response Example

Code
 
{
  "recording_uuid": "eee9c5eb-9f8e-48d5-8bab-7b3bea337b3d",
  "usecase_uuid": "de112ad9-7eb0-4eff-84da-d7bd827739ce",
  "file_name": "9345601106_135033_2026-07-20-11-09-32_1787026319827.mp3",
  "file_metadata": {
    "bucket": "vozzo-call-intel-dev",
    "client_org": "18412186-59e9-4e65-b8d5-62aa7bcc4f0f",
    "request_id": "eee9c5eb-9f8e-48d5-8bab-7b3bea337b3d",
    "client_profile": "de112ad9-7eb0-4eff-84da-d7bd827739ce",
    "analysis_config": {
      "analysis_tags": [],
      "analysis_buckets": [
        {
          "bucket_name": "Resolved",
          "bucket_description": "Customer query answered"
        }
      ],
      "call_flow_config": {
        "prompt": "",
        "enabled": false,
        "questions": [],
        "document_key": ""
      },
      "compliance_config": {
        "prompt": "",
        "enabled": false,
        "questions": [],
        "document_keys": []
      },
      "analysis_questions": [
        {
          "type": "yes_no",
          "question": "Did the agent greet the customer?"
        }
      ],
      "is_comprehend_required": false
    },
    "recording_duration": 16,
    "analysis_object_key": "18412186-59e9-4e65-b8d5-62aa7bcc4f0f/de112ad9/analysis/eee9.json",
    "recording_file_name": "9345601106.mp3",
    "recording_file_size": 59904,
    "recording_object_key": "18412186-59e9-4e65-b8d5-62aa7bcc4f0f/de112ad9/recordings/9345601106.mp3",
    "recording_file_extension": ".mp3",
    "transcription_object_key": "18412186-59e9-4e65-b8d5-62aa7bcc4f0f/de112ad9/transcription/eee9.json"
  },
  "call_analytics": {
    "tags": [],
    "goals": [],
    "category": "Escalated / Transferred",
    "call_flow": null,
    "sentiment": null,
    "compliance": null,
    "csat_score": null,
    "call_summary": "The call was between an AI-powered agent and a customer...",
    "call_objective": "",
    "agent_questions": [
      {
        "type": "yes_no",
        "answer": "Yes",
        "question": "Did the agent greet the customer?"
      }
    ],
    "agent_performance": {
      "politeness": "High",
      "response_time": "Best",
      "problem_solving": "High"
    },
    "root_cause_analysis": {
      "primary_issue": ""
    }
  },
  "transcription_ref": "s3://vozzo-call-intel-dev/.../transcription.json",
  "analysis_ref": "s3://vozzo-call-intel-dev/.../analysis.json",
  "processing_state": "ANALYSIS_COMPLETED",
  "processing_history": [
    {
      "state": "INITIATED",
      "timestamp": "2026-08-18T09:42:10.854234+05:30"
    }
  ],
  "is_active": true,
  "recording_duration": 16,
  "created_at": "2026-08-18T04:12:10.854214+00:00",
  "updated_at": "2026-08-18T04:13:43.995179+00:00",
  "duration_seconds": 16
}

Get Audio Presigned URL

Generate a secure, temporary URL to download or stream the original audio file.

Endpoint POST {{baseUrl}}/v1alpha/callintel/org-usecases/recording/get-audio-presigned-url

Request Body

Code
 
{
  "s3_key": "33bbb237-6256-4c81-b423-a5bd16af5a32/815545c1-61c1-4ec7-aa14-365a07909937/recordings/4cb66f57-f16b-461d-a670-6585b2fe9456.wav"
}

Response Example

Code
 
{
  "presigned_url": "https://vozzo-call-intel-dev.s3.ap-south-1.amazonaws.com/33bbb237.../recordings/4cb66f57.wav?X-Amz-Security-Token=..."
}

Download CSV Export

Download a CSV export containing the logs and analytics summary for all recordings in a use case.

Endpoint POST {{baseUrl}}/v1alpha/callintel/org-usecases/recordings/download-csv

Request Body

Code
 
{
  "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937",
  "status": "COMPLETED",
  "search_term": ""
}

This endpoint returns a StreamingResponse with media_type="text/csv".

Delete Recording

Permanently delete a recording and its associated analysis data.

Endpoint DELETE {{baseUrl}}/v1alpha/callintel/recording/{recording_uuid}

Response Example

Code
 
{
  "message": "Recording deleted successfully",
  "recording_uuid": "4cb66f57-f16b-461d-a670-6585b2fe9456"
}