Skip to main content
PUT
/
cloud
/
alerts
/
statuses
/
{key}
curl -X PUT 'https://api.cloud.blnkfinance.com/alerts/statuses/PENDING_REVIEW' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Awaiting Review",
    "colour": "#10B981"
  }'

{
  "organization_id": "org_01ABC123",
  "key": "PENDING_REVIEW",
  "name": "Awaiting Review",
  "colour": "#10B981",
  "created_at": "2025-01-29T14:00:00Z",
  "updated_at": "2025-01-29T14:30:00Z"
}
Update a custom alert status’s name and/or colour. The status is identified by its key.

​
Request structure

curl -X PUT 'https://api.cloud.blnkfinance.com/alerts/statuses/PENDING_REVIEW' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Awaiting Review",
    "colour": "#10B981"
  }'
​
key
string
The status key to update (e.g. PENDING_REVIEW). Case-insensitive.
​
name
string
required
New display name for the status.
​
colour
string
required
New hex colour code. Must be one of the values in allowed_colours from the list statuses response.

​
Response structure

{
  "organization_id": "org_01ABC123",
  "key": "PENDING_REVIEW",
  "name": "Awaiting Review",
  "colour": "#10B981",
  "created_at": "2025-01-29T14:00:00Z",
  "updated_at": "2025-01-29T14:30:00Z"
}
​
organization_id
string
required
Organization ID that owns the status.
​
key
string
required
The status key.
​
name
string
required
Display name of the status (after update).
​
colour
string
required
Hex colour code of the status (after update).
​
created_at
timestamp
required
ISO 8601 timestamp when the status was created.
​
updated_at
timestamp
required
ISO 8601 timestamp when the status was last updated.

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.