You can start using Daruma's REST API Within a few minutes:
Before you begin
To get started, create a Daruma account or log in.
This guide walks you through a simple interaction with the Daruma REST API: Import a design file and convert it to obtain JSON files and assets. For more details and additional API functionality, refer to the API reference and explore the available endpoints.
Step 1 - Get your API token
Enter the Daruma Dashboard page, click on the avatar and select API token. Now, you can create your first API token from the page.

In the following steps, you will need this generated token to verify the request.
Step 2 - Create a Daruma
Use the /api/daruma/import/file
endpoint send a request to the Daruma server to upload the design file.
$VGG_DARUMA_TOKEN
is a variable, please replace it with the actual Daruma authorization token generated in Step 1.
bashcurl -X POST 'https://verygoodgraphics.com/api/daruma/import/file' \ -H 'Authorization: Bearer '"$VGG_DARUMA_TOKEN"'' \ -H "Content-Type: application/json" \ --data '{"filename":"string"}'
In this step, you will receive the darumaImport.id
returned by the API response, please note that it is different from darumaId
. This step will return a URL.
Step 3 - Upload a design file
You need to fill the URL parameters returned by the previous step into the url_from_create_api_endpoint
. Locate the Sketch, Figma, or Adobe Illustrator file on your computer and enter its exact path in the -F 'file=@"/path/to/your/file"'
.
bashcurl -X PUT 'site_url + url_from_create_api_endpoint' \ -F 'file=@"/path/to/your/file"'
This call should return a status code of 200
.
Step 4 - Covert a design file
Use the /api/daruma/import/convert
endpoint to send a request for converting design file. Please note that importId
and quality
need to be replaced according to the actual situation. The generated artboard image quality has four levels, please choose according to your needs. (1-4, default: 2)
bashcurl -X POST 'https://verygoodgraphics.com/api/daruma/import/convert?importId=your_import_id&quality=your_quality_level' \ -H 'Authorization: Bearer '"$VGG_DARUMA_TOKEN"'' \ -H "Content-Type: application/json"
This step will return a taskId
parameter. This call should return a status code of 200
.
Step 5 - Get a conversion status
Send a request to /api/daruma/import/status/task
endpoint to confirm the conversion status of the design file and ensure that the conversion has been completed.
Please fill in the returned api response taskId
before sending the request.
bashcurl -X GET 'https://verygoodgraphics.com/api/daruma/import/status/task?taskId=string' \ -H 'Authorization: Bearer '"$VGG_DARUMA_TOKEN"''
Step 6 - Get JSON data and images in file
Use the /api/daruma/get/design
endpoint to retrieve JSON data for design file.
bashcurl -X GET 'https://verygoodgraphics.com/api/daruma/get/design?darumaId=string' \ -H 'Authorization: Bearer '"$VGG_DARUMA_TOKEN"''
The API response will return a URL. This call should return a status code of 200
.
Use the /api/daruma/get/resource/artboards
endpoint to obtain rendered images of design file.
bashcurl -X GET 'https://verygoodgraphics.com/api/daruma/get/resource/artboards?darumaId=string' \ -H 'Authorization: Bearer '"$VGG_DARUMA_TOKEN"''
The API response will return a URL List. This call should return a status code of 200
.
For more information about the Daruma formats and how to invoke different interfaces, please refer to the API reference.