JsonCutDocs
V2 APIEndpointsProjects

Update project metadata

Update project metadata. Durable editable image and video projects. Source versions use optimistic concurrency and can be opened in Studio. Required API key scopes: `projects:write`.

PATCH
/api/v2/projects/{id}

Authorization

apiKeyAuth

Path Parameters

id*string

Resource identifier

Header Parameters

If-Match?string

Exact current project version. Required for overwriting mutations unless the numeric body version is supplied for compatibility.

Match^"?[0-9]+"?$

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/api/v2/projects/string" \  -H "If-Match: "1"" \  -H "Content-Type: application/json" \  -d '{    "name": "Updated launch video",    "description": "Ready for review",    "tags": [      "launch",      "social"    ],    "folder": "Campaigns"  }'
{  "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": []    }  }}

Get a project GET

Get a project. Durable editable image and video projects. Source versions use optimistic concurrency and can be opened in Studio. Required API key scopes: `projects:read`.

Move a project to recoverable trash DELETE

Move a project to recoverable trash. Durable editable image and video projects. Source versions use optimistic concurrency and can be opened in Studio. Required API key scopes: `projects:delete`.