v1

latestOpenAPI 3.0.22026-07-261040577.4 KB
Tags

Create tag

Create a new tag within a project. Tags are labels used to categorize highlights — for example "Usability Issue", "Feature Request", or "Positive Feedback". Each tag must belong to a specific project (via project_id).

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.

post/v1/tags

Request body

titlestring required

The tag's title.

project_idstring required

Unique identifier of the project to create the tag in.

Example request

{
  "title": "Usability Issue"
}

Response

201