Skip to content

project/tagfolders

Lists tag folders for one project.

Method and path

GET /project/tagfolders/{project_id}

Authentication

Authentication is required. See Authentication.

Permissions

Accessible to tiers 1, 2, 3, and 4.

Request headers

HeaderRequiredDescription
X-Api-Key or X_API_KEYyesAPI key.

Path parameters

ParameterTypeRequiredDescription
project_idintegeryesProject identifier.

Example request

bash
curl "$SIGNAL_API_BASE_URL/project/tagfolders/<project_id>" \
  -H "X-Api-Key: $SIGNAL_API_KEY"

Example response

json
{
  "data": [
    {
      "id": 7,
      "label": "Example Folder"
    }
  ]
}

Response fields

FieldTypeDescription
dataarray<object>Tag folder collection.

Tag folder object fields

FieldTypeDescription
idintegerTag folder identifier.
labelstringTag folder label.

Notes

  • When no folders are available, the endpoint returns {"data": []}.

Doc rev.1.12.3 2026.05.08