Ellipsis APIReferenceAlerts

Get Alert

Return one alert by id; 404 if it doesn't exist or belongs to another customer.

GET
/v1/alerts/{alert_id}

Return one alert by id; 404 if it doesn't exist or belongs to another customer.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

alert_id*Alert Id

Header Parameters

user-agent?string|null

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/alerts/string"
{  "body": "string",  "created_at": "2019-08-24T14:15:22Z",  "cta_label": "string",  "cta_url": "string",  "customer_id": "string",  "dedupe_key": "string",  "id": "string",  "resolved_at": "2019-08-24T14:15:22Z",  "resolved_by": 0,  "severity": "info",  "source": "budget",  "status": "open",  "title": "string",  "updated_at": "2019-08-24T14:15:22Z"}

List Alerts

List the caller's organization-scoped alerts (budget alerts in v1), optionally filtered by status and source. Available to all credential types, so an agent can check "is this org near budget?" mid-task.

Dismiss Alert

Dismiss an open alert and return it. 409 when the alert is not open; 404 when it doesn't exist.