---
title: "Update an existing report chart"
method: PATCH
path: "/v1/org/{orgId}/report/chart/{chartId}"
tags: ["reportChart"]
---

# Update an existing report chart

`PATCH /v1/org/{orgId}/report/chart/{chartId}`

## Path parameters

- `orgId` string, required
- `chartId` string, required

## Request body

- UpdateReportChart
  - `label` string — chart label
  - `type` 'LINE' | 'AREA' | 'STACKED' | 'BAR' | 'VERTICAL_BAR' | 'HORIZONTAL_BAR' | 'PIE' | 'TABLE' | 'TABLE_CROSSTAB' | 'SINGLE_METRIC' | 'BUBBLE' | 'HEADER' | 'TEXT' | 'GAUGE' | 'WATERFALL' | 'WATERFALL_TIMESERIES' | 'HEATMAP' | 'GEO' | 'GEO_HEATMAP' | 'GEO_SCATTER' | 'RADAR' | 'N_GRID' | 'NETWORK' | 'COMBO' | 'COMBO_TIMESERIES' | 'DONUT' | 'FUNNEL' | 'FUNNEL_TIMESERIES' | 'SANKEY' | 'SANKEY_TIMESERIES' | 'WORDCLOUD' | 'EMOJI_CLOUD' | 'CALENDAR_HEATMAP' | 'GANTT' — chart type
  - `filter` string — filter that applies to this chart
  - `filterOverride` boolean — whether the chart filter overrides the global filter
  - `query` ReportQuery
    - `series` ReportSeriesQuery[] — series to evaluate
      - `label` string, required — label to use
      - `color` string, required — color to use
      - `y` string, required — y-value to calculate
      - `groupByConfigs` GroupByConfig[] — Configuration for aggregations performed by the groupBy operator
        - `overrides` LabelOverride[] — Overrides by label of label, color, or sort order
          - `id` string, required — The unique identifier to use to locate the key to override. For entities and enum values, this will be an id. For numbers, this will be the normalized numeric representation. For others, this will be the string
          - `label` string — If set, overrides this label
          - `color` string — If set, overrides the default color
          - `sort` integer — If set, overrides the sorting order
        - `limit` integer — Maximum number of results to display
        - `includeOther` boolean — When combined with limit, whether to include an 'Other' group
        - `includeNone` boolean — Whether to include a 'None' group (null values aggregated)
        - `includeAllValues` boolean — When combined with fieldId or questionId, will include all values from that fieldId or questionId, even if none of them were used
        - `fieldId` string — The field to use to retrieve values, when includeAllValues is in use
        - `questionId` string — The question to use to retrieve values, when includeAllValues is in use
        - `sortBy` 'LABEL' | 'KEY' | 'VALUE' | 'COUNT' — Whether to sort the results -- by default, will sort by label if there is no limit, will sort by value descending if there is a limit
        - `sortDirection` 'ASC' | 'DESC' — The direction to sort the results
    - `filters` ReportFilter[] — filters to crosstab all results by (deprecated in reports V2, should use groupBy instead)
      - `label` string, required — human-readable label for the filter
      - `filter` string, required — filter expression
    - `content` string — content block to evaluate as a Carrot Template, as an alternative to using series
    - `startDate` string — start date, in either relative (-7d) or exact (YYYY-MM-DD) format
    - `endDate` string — end date, in either relative (-7d) or exact (YYYY-MM-DD) format; if not present, defaults to today
    - `interval` 'DAY' | 'WEEK' | 'MONTH' | 'QUARTER' | 'FISCAL_QUARTER' | 'YEAR' | 'FISCAL_YEAR' — interval, if the query is a timeseries; if no interval, query is crosstabbed
    - `intervalDates` string[] — interval dates, if a specific set of irregular dates are being queried in a timeseries
    - `options` object, required — options, including format, filter, scenarioId, projectHires, and numerous display options
  - `sort` integer — sort order
  - `isAdvancedQueryMode` boolean — whether the chart configuration is using advanced mode

## Response `204`

updated

## Other responses

- `400` — invalid data
- `401` — not authorized
- `403` — permission denied
- `404` — not found

---

[API](https://skmtc.dev/charthop/apis/charthop-api.md) · [All operations](https://skmtc.dev/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/charthop/charthop-api/revisions/4685d95a20b1/schema)