POpoll-the-people
Tags

List all tags.

Changed on

Returns all tags configured for an agent, along with the users assigned to each tag. Use this to review your access control configuration or build a tag management interface.

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

Notes: Requires Custom plan.

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

Request

Path parameters

projectIdinteger required
Example:1

The ID of the project

Query parameters

pageinteger
Example:1

Page number to return.

limitinteger
Example:100

Maximum number of tags to return per page. Maximum is 100.

Response

List tags with assigned users for a project

status'error' | 'success'

The status of the response

Example response

{
  "status": "success",
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": 1,
        "name": "German",
        "users": [
          "manager@example.com"
        ]
      }
    ],
    "first_page_url": "https://app.customgpt.ai/api/v1/users?page=1",
    "from": 1,
    "last_page": 1,
    "last_page_url": "https://app.customgpt.ai/api/v1/users?page=1",
    "next_page_url": "https://app.customgpt.ai/api/v1/users?page=1",
    "path": "https://app.customgpt.ai/api/v1/users?page=1",
    "per_page": 10,
    "prev_page_url": "https://app.customgpt.ai/api/v1/users?page=1",
    "to": 1,
    "total": 1
  }
}

Changes