errors.release-health.list

List a project’s releases with their sessions, crash-free sessions and users, adoption and new issues

GET /errors/api/projects/{id}/release-healthIAM errors:GetEventsRead

Request syntax

GET /errors/api/projects/{id}/release-health

Path parameters

  • idRequired

    string

    Constraints: uuid

Query parameters

  • rangeOptional

    enum

    Window counted back from now: the last 24 hours or 14 days (default)

    One of: 24h, 14d

    Default: "14d"

  • limitOptional

    number

    Most releases to return, the most recently seen first: 1–200, default 50

    Constraints: integer, 1-200

    Default: 50

  • environmentOptional

    string

    Only this environment's sessions, e.g. production (DGPT §7); omitted: every environment together

    Constraints: max 64 chars

Response

200 with a row per release, the most recently seen first: release, sessions, crashed, errored, users, crashedUsers, crashFreeSessions and crashFreeUsers (0–1, null without sessions or known users), adoption (its share of the window’s sessions, 0–1), firstSeen, lastSeen, newIssues (issues first seen in it). 404 when the project does not exist, 403 without errors:GetEvents on it.

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow errors:GetEvents on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud errors release-health list id

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_errors_release-health_list.