Skip to main content
POST
/
v0
/
tags
Create a new tag
curl --request POST \
  --url https://api.avidoai.com/v0/tags \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-application-id: <api-key>' \
  --data '
{
  "name": "API Documentation",
  "color": "#3B82F6",
  "description": "Tag for API-related documentation"
}
'
{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "API Documentation",
    "color": "#3B82F6",
    "createdAt": "2024-01-05T12:34:56.789Z",
    "modifiedAt": "2024-01-05T12:34:56.789Z",
    "orgId": "org_123456789",
    "description": "Tag for API-related documentation"
  }
}

Authorizations

​
x-api-key
string
header
required

Your unique Avido API key

​
x-application-id
string
header
required

Your unique Avido Application ID

Body

application/json

Request body for creating a new tag

​
name
string
required

Name of the tag

Minimum string length: 1
Example:

"API Documentation"

​
color
string
default:#3B82F6

Hex color code for the tag

Example:

"#3B82F6"

​
description
string

Optional description of the tag

Example:

"Tag for API-related documentation"

Response

Tag created successfully

Successful response containing the tag data

​
data
Tag · object
required

A tag that can be applied to documents for organization