amp charts

amp charts lists, inspects, and queries saved charts. This read-only command family requires the analytics:read scope.

amp charts list

bash
amp charts list --project <project_id> --limit 5
amp charts list --project <project_id> --chart-type funnels --sort -updated_at

Use --q to search by name and --chart-type to narrow the results. Sort by updated_at or name; prefix the value with - for descending order. The default is -updated_at.

List responses omit chart definitions. In an interactive terminal, amp prints a table. Pipe the result or pass --json to get the raw API response.

amp charts get

bash
amp charts get --project <project_id> --chart <chart_id>
amp charts get --project <project_id> --chart <chart_id> --include-definition

Pass --include-definition to include the chart's read-only definition. Its shape may change between API versions, so don't use it to author or update charts.

amp charts query

bash
amp charts query --project <project_id> --chart <chart_id>
amp charts query --project <project_id> --chart <chart_id> \
  --time-range '{"start":"2026-07-01","end":"2026-07-31"}' \
  --timezone America/Los_Angeles

Query supports event segmentation, sessions, funnels, and retention charts. Other chart types return 422 with error_code: "unsupported_chart_type".

If you omit --time-range, the query uses the chart's saved range or the last 30 days when the chart has no saved range. The command also accepts --exclude-incomplete-datapoints, --group-by-limit, and --time-series-limit. Run amp charts query --help for the complete parameter reference.

Although query uses an HTTP POST, it only computes results and doesn't modify the chart. It doesn't require an idempotency key.

Was this helpful?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

On this page