Skip to main content
POST
/
api
/
v1
/
insights
/
folders
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.create(request={
        "name": "customer-complaints",
        "label": "support",
        "description": "Call recordings related to customer complaints",
    })

    # Handle response
    print(res)
{
  "name": "<string>",
  "id": 123,
  "last_updated_by": "<string>",
  "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

Body

application/json

Request model to create/update an insight upload folder.

name
string
required

Human-readable name of insight folder

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"

Response

InsightsFolder · object | null

Successful Response

Response model for an insight upload folder.

name
string
required

Human-readable name of insight folder

id
integer
required

System-assign folder ID

last_updated_by
string
required

Email of user who last updated upload folder

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

updated_at
string<date-time>

Timestamp at which insight upload folder was last updated