Bulk update notification status
Overview
Bulk-updates the lifecycle status of one or more error notifications, marking them acknowledged or resolved.
Prerequisites
- A bearer token. Callable with Partner tokens.
Base URL
| Environment | URL |
|---|---|
| Production | https://production-api.shoutaboutus.com |
| Development | https://development-api.shoutaboutus.com |
Endpoint
POST /api/v1/partner/error-notifications/status/update
Authentication
- Requires a bearer token in the
Authorization: Bearer <bearer-token>header. - Who can call it: Partner tokens.
- Authentication is under the
partnerprefix. - The request validation checks that each
id.*exists inerror_notifications. - The controller loads all rows by id and updates them (no partner-tree / company scoping on which ids may be updated).
resolvedsetsresolved=1,status='none',resolved_at=now;acknowledgedsetsstatus='acknowledged'.- Each updated row is also stamped
notified=1/notified_at(only when the caller'scompany_idis present and the row was not already notified).
Rate limit
- No rate limit.
Request body
- Body:
| Field | Type | Required | Description |
|---|---|---|---|
id | array of integers | Yes | Notification ids; each must be a known notification. |
status | string | Yes | One of resolved, acknowledged. |
{
"id": [
1,
2,
3
],
"status": "acknowledged"
}Response
data.message(string) —Selected notifications have been marked as Acknowledged./. Resolved.(status is ucfirst-ed), orSome notifications not found.if any save failed.
200 Success · 200
200{
"data": { "message": "Selected notifications have been marked as Acknowledged." }
}Errors
| Status | Meaning |
|---|---|
401 | The bearer token is missing, expired or invalid |
422 | The request failed validation — the response names the fields |
500 | Unexpected server error |
Example request
curl --request POST \
--url "https://production-api.shoutaboutus.com/api/v1/partner/error-notifications/status/update" \
--header 'Authorization: Bearer <bearer-token>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"id": [1, 2, 3], "status": "acknowledged"}'Updated 11 days ago
Did this page help you?
