Appearance
project/tag
Returns one tag in a project.
Method and path
GET /project/tag/{project_id}/{tag_id}
Authentication
Authentication is required. See Authentication.
Permissions
Accessible to tier 1, 2, and 3 users.
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. |
tag_id | integer | yes | Tag identifier. |
Example request
bash
curl "$SIGNAL_API_BASE_URL/project/tag/<project_id>/<tag_id>" \
-H "X-Api-Key: $SIGNAL_API_KEY"Example response
json
{
"id": 456,
"label": "Example Tag",
"alert_whitelist": 0,
"public_tag": 1,
"tag_folder": {
"id": 7,
"label": "Example Folder"
}
}Response fields
| Field | Type | Description |
|---|---|---|
id | integer | Tag identifier. |
label | string | Tag label. |
alert_whitelist | integer | boolean |
public_tag | integer | boolean |
tag_folder | object | Tag folder object. |
Notes
- If the tag is not found, the endpoint returns an empty response body with HTTP
200. - For tag write operations and rule management, see tag endpoints.