Skip to main content
POST
/
components
/
file
Import components via a file
curl --request POST \
  --url https://api.dittowords.com/v1/components/file \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'import=<string>'
{
  "componentsInserted": 123,
  "firstImportedId": "<unknown>"
}

Authorizations

​
Authorization
string
header
required

Query Parameters

​
folderId
string

The API ID of the folder you want to import components into. If not specified, components will be imported into the root of your component library.

Body

multipart/form-data
​
import
string

The absolute path to the file you want to import. Postman and other tools support directly uploading files, but if you're using cURL you'll need to use the @ prefix, e.g. curl -F import=@/path/to/file.json

Response

200 - application/json

Returns how many components were inserted.

​
componentsInserted
number
required