Skip to navigation
API ReferenceAssets

Move an asset

Beta

Move an asset into a folder or to the workspace root. The asset ID determines the workspace used for authorization; parent_folder_id must belong to the same workspace. A move into a drive (target_drive_id, or a parent_folder_id inside a drive) carries the asset’s whole folder subtree, so it is refused unless the caller can edit every item in it.

Authentication

X-API-KEYstring
API Key authentication via header

Path parameters

asset_idstringRequired
Unique identifier of the asset to move

Headers

X-Athena-Session-CredentialstringOptional

Request

This endpoint expects an object.
parent_folder_idstring or nullOptional
ID of the destination folder. Pass null or omit the field to move the asset to the workspace root.
target_drive_idstring or nullOptional

Optional drive asset ID. When provided without parent_folder_id, the asset moves to the drive root.

Response

Asset moved successfully
asset_idstring
ID of the moved asset
asset_typestring
Type of the moved asset
titlestring
Title of the moved asset
parent_folder_idstring or nullOptional
ID of the new parent folder, or null for workspace root
workspace_idstring or nullOptional
ID of the workspace that owns the asset

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error