Create an HTML-first video or image project
Create an HTML-first video or image project. Durable editable image and video projects. Source versions use optimistic concurrency and can be opened in Studio. Required API key scopes: `projects:write`.
Authorization
apiKeyAuth Request Body
application/json
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v2/projects" \ -H "Content-Type: application/json" \ -d '{ "source": { "format": "jsoncut-html", "version": 1, "id": "launch-image", "name": "Launch image", "compositionKind": "image", "canvasBackground": "transparent", "width": 1080, "height": 1080, "fps": 1, "duration": 1, "html": "<div id=\\"title\\" data-jc-clip data-jc-kind=\\"text\\" data-jc-name=\\"Title\\" data-jc-start=\\"0\\" data-jc-duration=\\"1\\" data-jc-track=\\"0\\" data-jc-bind-text=\\"title\\" style=\\"left:120px;top:460px;width:840px;height:160px;color:#fff;font:800 72px/1.1 Inter,sans-serif;text-align:center\\">Launch faster</div>", "css": "#jsoncut-canvas{background:linear-gradient(135deg,#111827,#FF9418)}", "variables": [ { "id": "title", "label": "Title", "type": "string", "default": "Launch faster" } ], "values": { "title": "Launch faster" }, "customBlocks": [] }, "description": "Layered launch artwork" }'{ "success": true, "data": { "id": "project_01J", "name": "Launch artwork", "description": "Editable social campaign", "compositionKind": "image", "width": 1080, "height": 1080, "fps": 1, "duration": 1, "status": "ready", "createdAt": "2026-08-25T09:00:00.000Z", "updatedAt": "2026-08-25T09:05:00.000Z", "thumbnail": "https://api.jsoncut.com/media/project_01J/thumbnail", "tags": [ "launch" ], "folder": "Campaigns", "version": 3, "source": { "format": "jsoncut-html", "version": 1, "id": "project_01J", "name": "Launch artwork", "compositionKind": "image", "canvasBackground": "transparent", "width": 1080, "height": 1080, "fps": 1, "duration": 1, "html": "<div id=\"title\" data-jc-clip data-jc-kind=\"text\" data-jc-name=\"Title\" data-jc-start=\"0\" data-jc-duration=\"1\" data-jc-track=\"0\" data-jc-bind-text=\"title\" style=\"left:120px;top:460px;width:840px;height:160px;color:#fff;font:800 72px/1.1 Inter,sans-serif;text-align:center\">Launch faster</div>", "css": "#jsoncut-canvas{background:linear-gradient(135deg,#111827,#FF9418)}", "variables": [ { "id": "title", "label": "Title", "type": "string", "default": "Launch faster" } ], "values": { "title": "Launch faster" }, "customBlocks": [] } }}Search, sort and organize projects GET
Search, sort and organize projects. Durable editable image and video projects. Source versions use optimistic concurrency and can be opened in Studio. Required API key scopes: `projects:read`.
Import a portable .jsoncut project bundle with its media POST
Import a portable .jsoncut project bundle with its media. Durable editable image and video projects. Source versions use optimistic concurrency and can be opened in Studio. Required API key scopes: `projects:write`.