ASasksyllable
insights.folders

Create Insights Upload Folder

post/api/v1/insights/folders/

Request

  • Base URL
    https://api.syllable.cloud
  • URL
    https://api.syllable.cloud/api/v1/insights/folders/
  • Auth
    API key in header Syllable-API-Key

Request body

namestring required

Human-readable name of insight folder

labelstring nullable

optional label assigned to insight folder

descriptionstring nullable

Text description of insight upload folder

Example request

{
  "name": "customer-complaints",
  "label": "support",
  "description": "Call recordings related to customer complaints"
}

Response

Successful Response

namestring required

Human-readable name of insight folder

labelstring nullable

optional label assigned to insight folder

descriptionstring nullable

Text description of insight upload folder

idinteger required

System-assign folder ID

created_atstring date-time

Timestamp at which insight upload folder was created

updated_atstring date-time

Timestamp at which insight upload folder was last updated

last_updated_bystring required

Email of user who last updated upload folder

Example response

{
  "name": "customer-complaints",
  "label": "support",
  "description": "Call recordings related to customer complaints",
  "id": 182764,
  "created_at": "2026-11-01T00:00:00Z",
  "updated_at": "2026-11-02T00:00:00Z",
  "last_updated_by": "user@email.com"
}

Changes

No operation changes recorded.