v1

latestOpenAPI 3.0.02026-07-24990169.2 KB

Create new visualization

Requires scope chart:write.

post/charts

Request body

titlestring

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

themestring

Chart theme to use.

typestring

Type of the chart (Reference)

forkableboolean

Set to true if you want to allow other users to fork this visualization

workspacestring

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

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.

externalDatastring

URL of external dataset

languagestring

Visualization locale (e.g. en-US)

lastEditStepinteger

Current position in chart editor workflow

Example request

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

Response

Successful