Projects

List grouped error fingerprints with a release-baselined verdict

The platform's durable error memory: uncaught throws, boot crashes (init crash-loops that never produce an app log line), invoke-level failures (throttle exhaustion, payload caps), and coarse handled-5xx — grouped by deploy-stable fingerprint and attributed to the release each identity was first seen under. The response LEADS with a computed verdict (new/recurring counts vs the baseline release, invocation volume, fidelity coverage). new_in=<release_id|active> is the promote-gate query: run402 errors list --new-in <release_id> --watch 10m --fail-on-new exits 0 when no new identities appeared. Platform traffic-shaping denials (rate limits, auth gates) are never counted as app errors. Auth: the project's own apikey OR a GitHub-OIDC CI session bearer for its own bound project (a deliberate, scoped v1.36 widening — a CI session already has deploy authority, so reading the resulting fingerprints is strictly less power and makes the promote gate keyless). Read-only, own-project-only; a CI session bound to a different project gets 403, a revoked binding 401.

get/projects/v1/{project_id}/errors

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/projects/v1/{project_id}/errors
  • Auth: one of:
    • API key in header apikey
    • HTTP bearer

Path parameters

project_idstring required

Run402 project ID. Public IDs are not UUIDs.

Example:prj_1741340000_0042

The caller's own project (the apikey's project, or a CI session's bound project). A valid credential for another project receives 403 — never an existence-revealing 404.

Query parameters

sincestring date-time

Window start (default: 24 hours before until).

untilstring date-time

Window end (default: now).

functionstring
kind'uncaught' | 'boot_crash' | 'invoke_failed' | 'handled_5xx'
fingerprintstring
new_instring

A release id (or active) — select identities FIRST seen under that release and compute the verdict against the previously active release.

limitinteger
cursorstring

Opaque keyset cursor from a prior page's next_cursor.

Response

Verdict + grouped error identities (newest activity first)

has_moreboolean required
next_cursorstring

Changes

No recorded changes to this operation across all 1 revision of this API.