Get Nudge

GET /v1/account/nudges/{uuid}

One nudge of your active account, by its uuid — for example to read its prompt after following a link to it. Unlike List Nudges, this returns the nudge whatever its status (pending or dismissed), and also while the account has muted nudges.

Permissions: any member of the active account; no role permission is needed.

Path parameters

uuid string (uuid) Req
The nudge's uuid from GET /v1/account/nudges.

Response (200 OK)

The nudge object: uuid, account_uuid, kind, dedupe_key, title, prompt, status, severity, created_at, and dismissed_at once it has been dismissed.

Deprecated: until the sunset this response also carries the legacy integer id and *_id fields. Don't use them; read uuid and the *_uuid fields.

Errors

401 Unauthorized
Missing or invalid auth.
403 Forbidden
No active account selected, or Not a member of this account.
404 Not Found
nudge not found — no nudge with that uuid in the active account (another account's nudge reads the same). A path segment that is not a uuid is a plain 404.
500 Internal Server Error
Failed to load nudge.
Request
curl "https://api.ngris.com/v1/account/nudges/019b002a-8b10-7965-8ec9-97bded381ab9" \ -H "X-API-KEY: <your_api_key>"
Response — 200 OK
{ "uuid": "019b002a-8b10-7965-8ec9-97bded381ab9", "account_uuid": "019b83f9-a245-7b20-8e76-4bb6e86a8d59", "kind": "error_rate", "dedupe_key": "errors", "title": "Elevated error rate: 31% over the last hour", "prompt": "My account is returning a lot of errors: 31% of requests failed (HTTP 4xx/5xx, excluding firewall and rate-limit blocks) over the last hour — 412 of 1329 requests, mostly on api.acme.example.com. Diagnose the likely cause, tell me whether it's an origin/app problem on my side or something at the edge, and walk me through the fix. Don't change anything without my confirmation.", "status": "dismissed", "severity": "warning", "created_at": "2026-10-20T08:15:00Z", "dismissed_at": "2026-10-20T09:02:41Z" }
On this page
Get Nudge