---
title: "Update specific chart properties."
method: PATCH
path: "/charts/{id}"
---

# Update specific chart properties.

`PATCH /charts/{id}`

Allows for partial metadata updates (via JSON merge patch). Requires scope `chart:write`.

## Path parameters

- `id` string, required

## Request body

- object
  - `title` string — Title of your chart. This will be the chart headline.
  - `theme` string
  - `type` string — Type of the chart ([Reference](https://developer.datawrapper.de/v3.0/docs/chart-types))
  - `externalData` string — URL of external dataset
  - `language` string — Visualization locale (e.g. en-US)
  - `lastEditStep` integer — Current position in chart editor workflow
  - `publicVersion` integer
  - `publicUrl` string
  - `publishedAt` string, date
  - `metadata` object — Metadata that saves all chart specific settings and options.
    - `data` object
      - `transpose` boolean
  - `authorId` integer
  - `organizationId` string — ID of the team (formerly known as organization) that the visualization should be created in. The authenticated user must have access to this team.
  - `folderId` integer — ID of the folder that the visualization should be created in. The authenticated user must have access to this folder.
  - `organization_id` string — Deprecated. Use organizationId instead.
  - `folder_id` integer — Deprecated. Use folderId instead.
  - `inFolder` integer — Deprecated. Use folderId instead.
  - `in_folder` integer — Deprecated. Use folderId instead.
  - `external_data` string — Deprecated. Use externalData instead.
  - `last_edit_step` integer — Deprecated. Use lastEditStep instead.
  - `author_id` integer — Deprecated. Use authorId instead.
  - `public_version` integer — Deprecated. Use publicVersion instead.
  - `public_url` string — Deprecated. Use publicUrl instead.
  - `published_at` string, date — Deprecated. Use publishedAt instead.

## Response `200`

Successful

---

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