Move an asset | Athena | API Reference Docs

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.

Authentication

X-API-KEYstring

API Key authentication via header

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

asset_idstringRequired

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 null

ID of the new parent folder, or null for workspace root

workspace_idstring or null

ID of the workspace that owns the asset

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

$	curl -X POST https://api.athenaintel.com/api/v0/assets/asset_id/move \
>	-H "X-API-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"parent_folder_id": "asset_folder_12345"
>	}'

1	{
2	"asset_id": "asset_92492920-d118-42d3-95b4-00eccfe0754f",
3	"asset_type": "document",
4	"title": "Quarterly Report Q1 2024",
5	"parent_folder_id": "asset_folder_12345",
6	"workspace_id": "workspace_abc123"
7	}