Skip to main content
POST
Move Items

Authorizations

Authorization
string
header
required

JWT in Authorization header. 'Bearer ' prefix optional.

Body

application/json

API request schema for moving filesystem items to a new parent directory

destination_directory_id
string<uuid>
required

ID of the destination parent directory

asset_ids
string<uuid>[] | null

List of asset IDs to move

directory_ids
string<uuid>[] | null

List of directory IDs to move

List of symlink IDs to move

conflict_resolutions
Conflict Resolutions · object | null

Resolution strategies for name conflicts. Keys are string UUIDs of conflicting items. Each value specifies the resolution strategy and optional auto-rename style. If not provided and conflicts exist, returns 409 with conflict details.

client_performed_at
string<date-time> | null

When the client performed this action. Defaults to server time if not provided.

Response

Successful Response

API response schema for moving filesystem items

moved_asset_count
integer
required

Number of assets successfully moved

moved_directory_count
integer
required

Number of directories successfully moved

Number of symlinks successfully moved

revision_results
MoveItemRevisionResult · object[]

Per-item revision info for each moved item