Nurama Developers
Projects

Move items to a new path within a project

Paths are relative to `project/{projectId}/{visibility}`. Requires `canMoveCreatorItems` for `creator` and `canMoveReviewerItems` for `reviewer`. Items already in the destination folder are skipped (`count` may be 0). A destination inside a virtual folder is a copy, not a move, and costs the right of the matching add route: `Public/{token}/...` requires `canAddPubicFileSystemItems`, `Submission/{id}/...` requires `canAddSubmittionItems`, and dropping onto `Review/...` publishes the items (requires `canPublishAsset`). Those responses carry `virtualDestination: true` (and `published: true` plus `errors` for `Review/`).

PUT
/projects/{projectId}/files/{visibility}/move

Paths are relative to project/{projectId}/{visibility}. Requires canMoveCreatorItems for creator and canMoveReviewerItems for reviewer. Items already in the destination folder are skipped (count may be 0).

A destination inside a virtual folder is a copy, not a move, and costs the right of the matching add route: Public/{token}/... requires canAddPubicFileSystemItems, Submission/{id}/... requires canAddSubmittionItems, and dropping onto Review/... publishes the items (requires canPublishAsset). Those responses carry virtualDestination: true (and published: true plus errors for Review/).

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

projectId*string

Unique ID of the project.

Formatuuid
visibility*string

Which tree to operate on — the creator tree or the reviewer tree.

Value in

  • "creator"
  • "reviewer"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

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