tag/delete

Deletes one or more tags and their associated tagging rules.

Method and path

POST /tag/delete

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.
Content-Type	yes	application/json.

Request body

Field	Type	Required	Description
project_id	integer	yes	Project identifier.
tag_id	integer or array<integer>	yes	One tag id or an array of tag ids.

Example request

curl -X POST "$SIGNAL_API_BASE_URL/tag/delete" \
  -H "X-Api-Key: $SIGNAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project_id": 123, "tag_id": [456, 457]}'

{
  "project_id": 123,
  "tag_id": [456, 457]
}

Example response

{
  "success": true
}

Response fields

Field	Type	Description
success	boolean	true when the delete query succeeds.
error	string	Error message returned when the delete query fails. Present only on failure.

Notes

• Bulk deletion is supported by sending an array in tag_id.
• The endpoint also deletes rule records attached to the deleted tags.