errors.profiles.list

List a project’s continuous profile chunks in a window (last 15 min, hour, day or custom): filters, samples per minute, the chunks

GET /errors/api/projects/{id}/profilesIAM errors:GetEventsRead

Request syntax

GET /errors/api/projects/{id}/profiles

Path parameters

  • idRequired

    string

    Constraints: uuid

Query parameters

  • windowOptional

    enum

    Last 15 minutes, hour or day, or custom with from/to

    One of: 15m, 1h, 24h, custom

    Default: "1h"

  • fromOptional

    string

    Custom window start (ISO 8601)

    Constraints: datetime

  • toOptional

    string

    Custom window end (ISO 8601)

    Constraints: datetime

  • environmentOptional

    string

    Only chunks of this environment

    Constraints: max 200 chars

  • releaseOptional

    string

    Only chunks of this release

    Constraints: max 200 chars

  • runtimeOptional

    enum

    node, browser or python

    One of: node, browser, python

  • profilerOptional

    string

    Only this profiler (one per process or page)

    Constraints: /^[0-9a-fA-F-]{32,36}$/

  • threadOptional

    string

    Thread id (default: the busiest)

    Constraints: max 100 chars

  • myCodeOptional

    enum

    Only in-app frames ("only my code")

    One of: 0, 1, true, false

  • compareOptional

    enum

    Also the previous window of the same length, per function

    One of: 0, 1, true, false

Response

200 with { from, to, facets, chunks, perMinute, latestAt, items }: `facets` what the window can be filtered on (environments, releases, runtimes, profilers with their chunk counts); `chunks` how many match; `perMinute` samples per minute; `latestAt` the newest chunk; `items` the latest 200 chunks (id, profilerId, platform, release, environment, startedAt, endedAt, samples). 400 for a custom window without from and to, ending before it starts, or longer than 7 days; 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 profiles 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_profiles_list.