---
title: "chart_set"
description: "Salva ou substitui uma visualização por `tableId` e `name`."
---

| Operação | Escopo OAuth | Descrição |
| :-- | :-- | :-- |
| `chart_set` | `files:write` | Salva ou substitui uma visualização por `tableId` e `name`. Recebe `type` (`bar`, `line`, `area`, `donut`), `x`, `y: {aggregation, column?}`, `description` obrigatória, `title`, `series`, `bucket` (`day`, `week`, `month`) e `filters: [{column, op, value}]` opcionais. Agregações numéricas exigem coluna numérica; agrupamento por data exige coluna de data. Filtros aceitam `eq`, `in`, `gte`, `lte`; `in` recebe uma lista não vazia, `gte`/`lte` recebem números ou datas não nulos. Exige escrita na tabela. Limite: 20 visualizações por tabela. |

Grupo: [Tabelas, registros e exportações](/docs/agents/mcp/tables-records-and-exports).