Create a new tag. Tags are labels used to categorize highlights — for example "Usability Issue", "Feature Request", or "Positive Feedback".

Pass project_id to create a project tag in that project. Omit it to create a workspace tag on a workspace tag board — workspace tags can be applied to highlights in every project linked to that board. Creating workspace tags requires a plan with workspace tags enabled.

By default the tag is created in the first group of the first tag board in the project or workspace. Pass tag_board_id and/or group_id to target a specific board or group (discover IDs via List tag boards). If the workspace has no tag board, create one in the Dovetail web app first.

Once created, the tag can be applied to highlights using the Create transcript highlight endpoint or in the Dovetail web app.

Returns the newly created tag object.

🚧

Permissions

Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.