Skip to main content
POST
/
contents
/
v1
/
tags
Create tag
curl --request POST \
  --url https://api.bigdata.com/contents/v1/tags \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "tag_name": "testing tag 2"
}
'
{
  "id": "019e3a99-6952-7dd4-adf5-b0b341959e11",
  "name": "testing tag 2",
  "created_at": "2026-05-18T10:19:53.044285Z",
  "updated_at": "2026-05-18T10:19:53.044290Z",
  "file_count": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-KEY
string
header
required

Your API key. Include it in every request as the X-API-KEY header. Create and manage keys in the Developer Platform.

Body

application/json

Request body for creating a custom tag.

​
tag_name
string
required

Display name for the new tag.

Example:

"testing tag 2"

Response

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

Detailed information about a tag.

​
id
string<uuid>
required

Unique identifier for the tag.

Example:

"019a48b4-e573-7203-945a-2e7c4c164217"

​
name
string
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).

Example:

"from:user@email.com"

​
created_at
string<date-time>
required

Timestamp when the tag was created.

Example:

"2025-11-03T07:53:26.150858Z"

​
updated_at
string<date-time>
required

Timestamp when the tag was last updated.

Example:

"2025-11-03T07:53:26.150859Z"

​
file_count
integer
required

Number of files associated with this tag.

Example:

40