Nurama Developers
Projects

Add reviewer-tree items to an existing submission

Copies items from the project's reviewer tree into the submission. `itemPaths` are relative to `project/{projectId}/reviewer` and `destinationPath` is relative to `submission/{submissionId}` (omit it to add at the submission root; a destination folder that does not exist returns 404). Marks the copied assets as belonging to the submission and recomputes its inventory. Requires `canAddSubmittionItems`; the submission must belong to `projectId`.

POST
/projects/{projectId}/submission/{submissionId}/add

Copies items from the project's reviewer tree into the submission. itemPaths are relative to project/{projectId}/reviewer and destinationPath is relative to submission/{submissionId} (omit it to add at the submission root; a destination folder that does not exist returns 404). Marks the copied assets as belonging to the submission and recomputes its inventory. Requires canAddSubmittionItems; the submission must belong to projectId.

Authorization

AuthorizationBearer <token>

OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.

In: header

Scope: projects:write

Path Parameters

projectId*string

Unique ID of the project.

Match^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Formatuuid
submissionId*string

The ID of the submission. Must belong to projectId.

Match^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/submission/497f6eca-6276-4993-bfeb-53cbbbba6f08/add" \  -H "Content-Type: application/json" \  -d '{    "itemPaths": [      "Renders/final.png",      "Renders/alt"    ]  }'
{  "count": 1,  "virtualDestination": true,  "published": true,  "errors": [    {      "type": "string",      "message": "string",      "data": null    }  ]}