errors_list
Retrieve release-baselined errors for a project. Verdict-first page shows promote-vs-revert outcome; post-promote, check new_fingerprints to detect new error identities introduced by a release.
Instructions
Grouped, release-baselined error memory for a project, verdict-first: every page leads with a computed promote-vs-revert verdict (the gateway's numbers — never recomputed here), then the collapsed error identities. The post-promote watch: right after an apply/promote activates a release, call errors_list with new_in set to the just-activated release id (the promote response's next_actions carries a ready-made watch_errors command for the CLI equivalent). verdict.new_fingerprints > 0 means the release introduced NEW error identities — inspect errors[] (each row has samples with request ids + a runnable logs command) and consider reverting; new_fingerprints === 0 with healthy verdict.invocations_in_window means clean under real traffic (0 errors over 0 invocations is absence of signal, not proven health). Filter by since/until/function/kind/fingerprint; pass fingerprint_id to fetch one fingerprint's full detail (all samples + also_seen_in_functions). Quality tier coarse = the function predates the error side-channel; redeploy to upgrade fidelity. Read-only, own-project service-key auth; cursors are opaque.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Restrict to one choke-point class: uncaught | boot_crash | invoke_failed | handled_5xx. | |
| limit | No | Page size (default 50, max 200). | |
| since | No | ISO-8601 window start. Default window is the last 24h (gateway resolves `until` − 24h). | |
| until | No | ISO-8601 window end. Defaults to now (gateway-side). | |
| cursor | No | Opaque `next_cursor` from a prior page. Returns the next page. Never parse cursors. | |
| new_in | No | A release id, or the literal "active" (gateway resolves the live release). Selects error identities FIRST seen under that release and drives the verdict's new_fingerprints / baseline — the promote-gate signal. | |
| function | No | Restrict to one function by name. | |
| project_id | Yes | Project whose errors to read. Authorized with the project's OWN service key; a key for a different project gets 403, never a 404. | |
| fingerprint | No | Restrict the list to one exact fingerprint identity (`fp_…`). | |
| fingerprint_id | No | Fetch ONE fingerprint's full detail (all samples, per-sample fetch_logs commands, also_seen_in_functions) instead of a page. When set, all filter params (since/until/function/kind/fingerprint/new_in/limit/cursor) are rejected. |