v1

latestOpenAPI 3.1.02026-07-2268276396.6 KB

Create tag

Creates a custom tag in your organization. Use the returned id when assigning tags to a document via PATCH /contents/v1/documents/{content_id} (pass tag IDs in the tags array, not names). Tag names supplied at upload time via POST /contents/v1/documents are resolved by name; for post-upload changes, use tag IDs from this endpoint or from List tags.

post/contents/v1/tags

Request body

tag_namestring required

Display name for the new tag.

Example request

{
  "tag_name": "testing tag 2"
}

Response

The created tag, including its id for use when updating document metadata.

idstring uuid required

Unique identifier for the tag.

namestring required

Name of the tag (e.g. from:user@email.com, to:user@email.com, broker:Broker Name or a custom one provided by the user).

created_atstring date-time required

Timestamp when the tag was created.

updated_atstring date-time required

Timestamp when the tag was last updated.

file_countinteger required

Number of files associated with this tag.

Example response

{
  "id": "019a48b4-e573-7203-945a-2e7c4c164217",
  "name": "from:user@email.com",
  "created_at": "2025-11-03T07:53:26.150858Z",
  "updated_at": "2025-11-03T07:53:26.150859Z",
  "file_count": 40
}