Skip to main content

How to organize recordings with folders and tags

Folders and tags keep a growing number of recordings easy to find, and folders decide who gets to see what. This guide shows how to use both through the API.

Before you start

Read the Quickstart first.

Quick navigation

  1. Folders
  2. Share folders
  3. Tags

1. Folders​

Folders form a tree: a folder can have a parent (parentFolderId), and a recording can be added to a folder and removed again.

PUT    /v1.0/directories/{directoryId}/folders/{folderId}/recordings/{recordingId}
DELETE /v1.0/directories/{directoryId}/folders/{folderId}/recordings/{recordingId}

The list of recordings in a folder can include subfolders with includeSubfolders=true.

2. Share folders​

Sharing happens on the folder, with individual users or with whole teams. That is the practical way to open a set of meetings to a department without touching every recording. Setting the shares replaces the complete list.

PUT /v1.0/directories/{directoryId}/folders/{folderId}/shares

Reference: PUT/v1.0/directories/{directoryId}/folders/{folderId}/shares

3. Tags​

Tags are labels on appointments and recordings. They are created once per company account in the tag catalog, carry a color from a fixed palette (for example blue or green) and are then assigned by id. Admins and owners manage the catalog.

PUT /v1.0/directories/{directoryId}/recordings/{recordingId}/tags

{ "tagIds": ["…"] }
Important

Assigning replaces the complete set of tags and only accepts ids of existing tags. Create a missing tag first, then assign it. A recording or an appointment can carry up to 20 tags of its own.