project/tags

Lists tags for one project.

Method and path

GET /project/tags/{project_id}

Authentication

Authentication is required. See Authentication.

Permissions

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

Request headers

Header	Required	Description
X-Api-Key or X_API_KEY	yes	API key.

Path parameters

Parameter	Type	Required	Description
project_id	integer	yes	Project identifier.

Example request

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

Example response

[
  {
    "id": 456,
    "label": "Example Tag",
    "alert_whitelist": 0,
    "public_tag": 1,
    "folder": {
      "id": 7,
      "label": "Example Folder"
    },
    "rules": [
      {
        "rule_id": 789,
        "tag": {
          "id": 456,
          "label": "Example Tag"
        },
        "tag_match_field": "post_text",
        "tag_match_rule": "contains",
        "tag_match_value": "example keyword"
      }
    ]
  }
]

Response fields

Field	Type	Description
Response body	array<object>	Collection of tags for the project.

Tag object fields

Field	Type	Description
id	integer	Tag identifier.
label	string	Tag label.
alert_whitelist	integer	boolean
public_tag	integer	boolean
folder	object	Assigned tag folder.
rules	array<object>	Tagging rules attached to this tag.

Notes

• This endpoint returns a top-level array.
• For tag write operations and rule management, see tag endpoints.