Create folder

Create a new folder in the workspace. You can create a root-level folder or a sub-folder by specifying a parentFolderId.

POST /api/v1/spaces/{spaceId}/folders

API key in header x-api-key

curl 'https://transcript.lol/api/v1/spaces/space_01JXY9AZK4KV/folders' \
  --request POST \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "My Folder",
  "parentFolderId": null
}'

{
  "id": "id_01JXY9AZK4KV",
  "createdAt": "2026-01-01T12:00:00Z",
  "updatedAt": "2026-01-01T12:00:00Z",
  "name": "example",
  "workspaceId": "workspace_01JXY9AZK4KV",
  "parentFolderId": "parent_folder_01JXY9AZK4KV"
}

Created folder

Path parameters

· 1

spaceId string required

ID of the workspace. You can find from the url in dashboard when you open the workspace or using the list workspaces endpoint.

Body

application/json

Folder details

name string required

Name of the folder

parentFolderId string · nullable required

ID of the parent folder. Pass null to create a root-level folder.

Path parameters

Body

Responses