POST
/
api
/
v1
/
insights
/
folders
/
{folder_id}
/
upload-file
import os
from syllable_sdk import SyllableSDK


with SyllableSDK(
    api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:

    res = ss_client.insights.folders.upload_file(folder_id=444923, call_id="<id>")

    # Handle response
    print(res)
{
  "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": "2025-07-01T00:00:00Z",
  "end_time": "2025-07-02T00:00:00Z",
  "error_message": "File not found",
  "metadata": {
    "duration": "00:10:00",
    "size": "10MB"
  },
  "created_at": "2025-07-01T00:00:00Z"
}

Authorizations

​
Syllable-API-Key
string
header
required

Path Parameters

​
folder_id
integer
required

Query Parameters

​
call_id
string
required

A unique identifier for the call

​
agent_number
string | null

The phone number or ID of the agent involved.

​
customer_number
string | null

The phone number or ID of the customer.

​
start_time
string | null

The timestamp of the call's beginning

​
end_time
string | null

The timestamp of the call's end.

​
duration
number | null

The call duration in seconds.

​
metadata
string | null

Body

multipart/form-data

Response

200
application/json

Successful Response

Response model for an insight upload file.

POST
/
api
/
v1
/
insights
/
folders
/
{folder_id}
/
upload-file
import os
from syllable_sdk import SyllableSDK


with SyllableSDK(
    api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:

    res = ss_client.insights.folders.upload_file(folder_id=444923, call_id="<id>")

    # Handle response
    print(res)
{
  "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": "2025-07-01T00:00:00Z",
  "end_time": "2025-07-02T00:00:00Z",
  "error_message": "File not found",
  "metadata": {
    "duration": "00:10:00",
    "size": "10MB"
  },
  "created_at": "2025-07-01T00:00:00Z"
}

Authorizations

​
Syllable-API-Key
string
header
required

Path Parameters

​
folder_id
integer
required

Query Parameters

​
call_id
string
required

A unique identifier for the call

​
agent_number
string | null

The phone number or ID of the agent involved.

​
customer_number
string | null

The phone number or ID of the customer.

​
start_time
string | null

The timestamp of the call's beginning

​
end_time
string | null

The timestamp of the call's end.

​
duration
number | null

The call duration in seconds.

​
metadata
string | null

Body

multipart/form-data

Response

200
application/json

Successful Response

Response model for an insight upload file.