insights.folders
Upload Insights Upload Folder
agents
channels.twilio.numbers
agents.test
conversations
data_sources
events
incidents
insights
insights.folders
insights.workflows
insights.tools
custom_messages
prompts
session_labels
sessions.transcript
sessions.full-summary
sessions.latency
session_debug
channels.targets
directory
dashboards
outbound.batches
- GETList Outbound Communication Batches
- POSTCreate Outbound Communication Batch
- GETGet Outbound Communication Batch
- PUTUpdate Outbound Communication Batch
- DELDelete Outbound Communication Batch
- POSTUpload Outbound Communication Batch
- GETFetch Outbound Communication Batch Results
- POSTCreate Outbound Communication Request
- POSTDelete Requests By List Of Reference Ids
outbound.campaigns
language_groups
insights.folders
Upload Insights Upload Folder
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=209119, 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-05-07T00:00:00Z",
"end_time": "2025-05-08T00:00:00Z",
"error_message": "File not found",
"metadata": {
"duration": "00:10:00",
"size": "10MB"
},
"created_at": "2025-05-07T00:00:00Z"
}
Authorizations
Path Parameters
Query Parameters
A unique identifier for the call
The phone number or ID of the agent involved.
The phone number or ID of the customer.
The timestamp of the call's beginning
The timestamp of the call's end.
The call duration in seconds.
Body
multipart/form-data
Response
200
application/json
Successful Response
Response model for an insight 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=209119, 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-05-07T00:00:00Z",
"end_time": "2025-05-08T00:00:00Z",
"error_message": "File not found",
"metadata": {
"duration": "00:10:00",
"size": "10MB"
},
"created_at": "2025-05-07T00:00:00Z"
}