Folders

Use the Folders API to organise transcripts into folders. You can list all folders, create new folders (including nested folders), and retrieve a single folder. Folders can belong to a personal workspace or a shared drive. Authenticate with Basic Authentication using your API key ID and secret.

List all folders

Return every folder available to you. Pass the optional workspace-id query parameter to scope the results to a particular workspace or shared drive. Nested folders include a parent field referencing the _id of their parent folder.

curl --request GET \  --url 'https://api.trint.com/folders/' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET'

[{
  _id: 'folder-1',
  name: 'Folder 1',
}, {
  _id: 'folder-2',
  name: 'Folder 2',
}, {
  _id: 'folder-3',
  name: 'Nested Folder',
  parent: 'folder-2',
}]

Create a new folder

Create a new folder. Provide a name, and optionally a parentId to nest the folder inside an existing one, or a workspaceId to create it within a specific workspace or shared drive.

curl --request POST \  --url 'https://api.trint.com/folders/' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'Content-Type: application/json' \
  --data '{}'

{}

Retrieve a single folder

Retrieve a single folder by its folderId. Pass the optional workspaceId query parameter when the folder belongs to a specific workspace or shared drive.

curl --request GET \  --url 'https://api.trint.com/folders/folder?folderId=YOUR_FOLDERID' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET'

{}