v66

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-04176310979.2 KB

insights.folders

Update Insights Folder

put/api/v1/insights/folders/{folder_id}

Path parameters

folder_idinteger required

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-08-03T00:00:00Z",
  "updated_at": "2026-08-04T00:00:00Z",
  "last_updated_by": "user@email.com"
}