Error Management
List, view, and manage errors.
List Errors
Request
curl "https://reflex.brainzlab.ai/api/v1/errors?status=unresolved" \
-H "Authorization: Bearer sk_live_xxx"
Query Parameters
| Parameter | Type | Description |
|---|
status | string | Filter: unresolved, resolved, ignored |
level | string | Filter: warning, error, fatal |
since | string | Time range (e.g., 24h, 7d) |
search | string | Search in error message |
limit | integer | Max results (default: 50) |
offset | integer | Pagination offset |
Response
{
"data": [
{
"id": "err_abc123",
"title": "PaymentError: Card declined",
"status": "unresolved",
"level": "error",
"occurrences": 45,
"users_affected": 12,
"first_seen": "2024-01-10T10:00:00Z",
"last_seen": "2024-01-15T14:30:00Z",
"assignee": null
}
],
"meta": {
"total": 150,
"limit": 50,
"offset": 0
}
}
Get Error Details
Response
{
"data": {
"id": "err_abc123",
"title": "PaymentError: Card declined",
"status": "unresolved",
"exception": {
"type": "PaymentError",
"message": "Card declined",
"backtrace": [...]
},
"occurrences": 45,
"users_affected": 12,
"first_seen": "2024-01-10T10:00:00Z",
"last_seen": "2024-01-15T14:30:00Z",
"latest_event": {
"id": "evt_xyz789",
"timestamp": "2024-01-15T14:30:00Z",
"user": { "id": "123" },
"tags": { "feature": "checkout" }
}
}
}
Resolve Error
POST /api/v1/errors/:id/resolve
Request
curl -X POST https://reflex.brainzlab.ai/api/v1/errors/err_abc123/resolve \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"note": "Fixed in commit abc123"
}'
Response
{
"data": {
"id": "err_abc123",
"status": "resolved",
"resolved_at": "2024-01-15T15:00:00Z"
}
}
Ignore Error
POST /api/v1/errors/:id/ignore
Request
curl -X POST https://reflex.brainzlab.ai/api/v1/errors/err_abc123/ignore \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"duration": "forever",
"reason": "Known issue, scheduled for later fix"
}'
Unresolve Error
POST /api/v1/errors/:id/unresolve
Assign Error
POST /api/v1/errors/:id/assign
Request
curl -X POST https://reflex.brainzlab.ai/api/v1/errors/err_abc123/assign \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"user_id": "user_456"
}'
Delete Error
DELETE /api/v1/errors/:id
This permanently deletes the error and all its events.
