Tags

Creates one or more new tags for document access control. Accepts an array of tag names, allowing bulk creation. After creating tags, assign them to documents and users to control access.

Tags are called labels in the API, so paths and fields use label (for example labelId and labels).

Notes: Requires Custom plan.

post/api/v1/projects/{projectId}/labels

Request

Path parameters

projectIdinteger required

The unique identifier of the agent. You can find this in the CustomGPT dashboard or from the response of POST /api/v1/projects.

Request body

namesstring[]

Tag names to create/restore (max 20 characters each, must not start with a digit)

Example request

{
  "names": [
    "Pricing",
    "FAQ"
  ]
}

Response

Create (or restore) tags within a project

status'error' | 'success'

The status of the response

Example response

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "name": "Pricing"
    }
  ]
}

Changes