Create a folder

POST

https://api.datawrapper.de/v3/folders

Requires scope folder:write.

Example Request

curl --request POST \
  --url https://api.datawrapper.de/v3/folders \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
  "workspace": "my-workspace",
  "name": "string"
}'

Headers

Name	Value	Required	Description
`Content-Type`	`application/json`	Yes	The format of the request body.

Request Body

Field	Type	Allowed values	Required	Description
`organizationId`	`string`		No	DEPRECATED: use `teamId` instead.
`teamId`	`string`		No	The team that the folder belongs to. If `teamId` is null, the folder will belong to the user directly.
`workspace`	`string`		No	Slug of the workspace that the folder should be created in. The authenticated user must have access to this workspace.
`parentId`	`number`		No	The parent folder that the folder belongs to.
`name`	`string`	128 characters or less	Yes	The name of the folder.