Skip to main content
GET
/
api
/
v1
/
insights
/
folders
/
{folder_id}
Python (SDK)
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.get_by_id(folder_id=982079)

    # Handle response
    print(res)
{
  "name": "<string>",
  "id": 123,
  "last_updated_by": "<string>",
  "folder_stats": {},
  "label": "support",
  "description": "Call recordings related to customer complaints",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Syllable-API-Key
string
header
required

Path Parameters

​
folder_id
integer
required

Response

Successful Response

Response model for an insight upload folder details.

​
name
string
required

Human-readable name of insight folder

Example:

"customer-complaints"

​
id
integer
required

System-assign folder ID

Example:

182764

​
last_updated_by
string
required

Email of user who last updated upload folder

Example:

"[email protected]"

​
folder_stats
Folder Stats · object
required

Meta-data of insight upload files associated with the folder

Example:
{
  "count": 10,
  "total_duration": "10:00:00",
  "total_size": "213MB"
}
​
label
string | null

optional label assigned to insight folder

Example:

"support"

​
description
string | null

Text description of insight upload folder

Example:

"Call recordings related to customer complaints"

​
created_at
string<date-time>

Timestamp at which insight upload folder was created

Example:

"2026-01-13T00:00:00Z"

​
updated_at
string<date-time>

Timestamp at which insight upload folder was last updated

Example:

"2026-01-14T00:00:00Z"