v1

latestOpenAPI 3.0.02026-07-24990169.2 KB

Update all chart properties

Replaces the entire metadata object. Requires scope chart:write.

put/charts/{id}

Path parameters

idstring required

5 character long chart ID.

Request body

titlestring

Title of your chart. This will be the chart headline.

themestring

typestring

Type of the chart (Reference)

externalDatastring

URL of external dataset

languagestring

Visualization locale (e.g. en-US)

lastEditStepinteger

Current position in chart editor workflow

publicVersioninteger

publicUrlstring

publishedAtstring date

authorIdinteger

organizationIdstring

ID of the team (formerly known as organization) that the visualization should be created in. The authenticated user must have access to this team.

folderIdinteger

ID of the folder that the visualization should be created in. The authenticated user must have access to this folder.

organization_idstring

Deprecated. Use organizationId instead.

folder_idinteger

Deprecated. Use folderId instead.

inFolderinteger

Deprecated. Use folderId instead.

in_folderinteger

Deprecated. Use folderId instead.

external_datastring

Deprecated. Use externalData instead.

last_edit_stepinteger

Deprecated. Use lastEditStep instead.

author_idinteger

Deprecated. Use authorId instead.

public_versioninteger

Deprecated. Use publicVersion instead.

public_urlstring

Deprecated. Use publicUrl instead.

published_atstring date

Deprecated. Use publishedAt instead.

Example request

{
  "title": "My cool chart",
  "theme": "datawrapper",
  "type": "d3-lines"
}

Response

Successful