Inspect and update saved-chart tags and groups

Use list_chart_tags to see chart IDs, names, tags, and groups. Use update_chart_tags only after an explicit request to add or remove labels on one owned saved chart. Repeating the same operation is idempotent, archived or unowned charts fail closed, and the tool never changes chart calculation data.

Request and response shapes

Input shape

{ limit?: number } | { chartId: string; addTags?: string[]; removeTags?: string[]; addGroups?: string[]; removeGroups?: string[]; idempotencyKey: string }

Output shape

{ charts: ChartTaxonomy[] } | { chart: ChartTaxonomy }

Examples

Request example

{
  "chartId": "chart_ada",
  "addTags": [
    "research"
  ],
  "addGroups": [
    "Clients"
  ],
  "idempotencyKey": "tag-chart-ada-research"
}

Response example

{
  "chart": {
    "chartId": "chart_ada",
    "tags": [
      "research"
    ],
    "groups": [
      "Clients"
    ]
  }
}

Common validation errors

Provide at least one non-empty tag or group change.
Chart taxonomy reads require charts:read and writes require charts:write.

Inspect and update saved-chart tags and groups

Request and response shapes

Input shape

{ limit?: number } | { chartId: string; addTags?: string[]; removeTags?: string[]; addGroups?: string[]; removeGroups?: string[]; idempotencyKey: string }

Output shape

{ charts: ChartTaxonomy[] } | { chart: ChartTaxonomy }

Examples

Request example

{
  "chartId": "chart_ada",
  "addTags": [
    "research"
  ],
  "addGroups": [
    "Clients"
  ],
  "idempotencyKey": "tag-chart-ada-research"
}

Response example

{
  "chart": {
    "chartId": "chart_ada",
    "tags": [
      "research"
    ],
    "groups": [
      "Clients"
    ]
  }
}

Common validation errors

Provide at least one non-empty tag or group change.
Chart taxonomy reads require charts:read and writes require charts:write.

Inspect and update saved-chart tags and groups

Request and response shapes

Input shape

Output shape

Examples

Request example

Response example

Common validation errors

Related questions

Inspect and update saved-chart tags and groups

Request and response shapes

Input shape

Output shape

Examples

Request example

Response example

Common validation errors

Related questions