Ellipsis APIReferenceAlerts

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.

GET
/v1/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.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Query Parameters

status?|null
source?|null
limit?Limit
Range1 <= value <= 200
Default100

Header Parameters

user-agent?string|null

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/alerts"
{  "alerts": [    {      "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"    }  ]}