Create a new tag for the company

Create a new tag for the authenticated user’s company. Requires tag creation permission.

POST /api/v3/tags

Create a new tag for the company

cURL

curl --request POST \
  --url https://paradigm.lighton.ai/api/v3/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tag": "<string>",
  "description": "<string>"
}
'

201

{
  "id": 3,
  "created_at": "2024-01-16T11:00:00Z",
  "updated_at": "2024-01-16T11:00:00Z",
  "tag": "Project Alpha",
  "description": "Documents related to the development and release of Project Alpha",
  "artificial": false
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Serializer for creating a tag.

tag · string · required

description · string · required

Response

201

application/json

Tag created successfully

Serializer for listing tags.

id · integer · required

tag · string · required

Title of the tag (max 100 characters).

description · string · required

Description of the tag (max 500 characters).

artificial · boolean · required

True if the tag was generated by the system, False if it was manually created.

created_at · string<date-time> · required

Timestamp when the tag was created.

updated_at · string<date-time> · required

Timestamp when the tag was last updated.