DocumentationAPI Reference
Alert tags

List alert tags

GET
/workspaces/{workspaceId}/alert-tags

Authorization

API key Alerts: read
AuthorizationBearer <token>

API key (sf_...) with any of the required scopes. Generate it in the Spotflow portal on the settings page.

In: header

Scope: Alerts: read

Path Parameters

workspaceId*string
Formatuuid

Response Body

application/json

curl -X GET "https://example.com/workspaces/00000000-0000-0000-0000-000000000001/alert-tags"

All alert tags in the workspace.

[  {    "id": "t8Pj42kLd6Nw",    "name": "Production",    "color": "#e11d48",    "createdAt": "2026-01-08T11:20:00+00:00"  },  {    "id": "u5Zm93bRf1Qs",    "name": "Needs investigation",    "color": "#f59e0b",    "createdAt": "2026-01-09T07:45:00+00:00"  }]