v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01176310978.7 KB

insights.folders

Upload Insights Upload Folder

post/api/v1/insights/folders/{folder_id}/upload-file

Path parameters

folder_idinteger required

Query parameters

call_idstring required

A unique identifier for the call

agent_numberstring nullable

The phone number or ID of the agent involved.

customer_numberstring nullable

The phone number or ID of the customer.

start_timestring date-time nullable

The timestamp of the call's beginning

end_timestring date-time nullable

The timestamp of the call's end.

durationnumber nullable

The call duration in seconds.

metadatastring nullable

Response

Successful Response

idinteger required

System-assigned ID for the upload file

folder_idinteger required

System-assigned ID for the folder to which the file belongs

filenamestring required

Name of the uploaded file

object_keystring required

Object-store key of the uploaded file

call_idstring nullable

Unique identifier for the call associated with the uploaded file

agent_numberstring nullable

Agent number associated with the uploaded file

customer_numberstring nullable

Customer number associated with the uploaded file

durationnumber nullable

Length in seconds of the uploaded recording

start_timestring date-time nullable

Start time of the uploaded file

end_timestring date-time nullable

End time of the uploaded file

error_messagestring nullable

Error message associated with the uploaded file

metadataobject nullable

Meta-data associated with the uploaded file

created_atstring date-time

Timestamp at which insight upload file was created

Example response

{
  "id": 182764,
  "folder_id": 182764,
  "filename": "customer-complaints.wav",
  "object_key": "UPLOAD_CALL_ID/recording/2025/04/22/15/00/ce7d212e-80b0-4f0b-9e01-74322f146611.mp3",
  "call_id": "12345",
  "agent_number": "1234567890",
  "customer_number": "0987654321",
  "duration": 305.5,
  "start_time": "2026-07-31T00:00:00Z",
  "end_time": "2026-08-01T00:00:00Z",
  "error_message": "File not found",
  "metadata": {
    "duration": "00:10:00",
    "size": "10MB"
  },
  "created_at": "2026-07-31T00:00:00Z"
}