PUT
/
v1
/
apps
/
{id}
/
files
/
move
Move Application File or Folder
curl --request PUT \
  --url https://api.vertracloud.app/v1/apps/{id}/files/move \
  --header 'Authorization: Bearer <token>'
{
  "status": "success"
}
id
string
required
The ID of the application to move the file or folder within. If the application belongs to an organization, include the organization ID in the format appId-orgId.
path
string
required
The source path of the file or folder to move.
to
string
required
The destination path to move the file or folder to.

Response

status
string
Indicates whether the call was successful. success if successful, error if not.
{
  "status": "success"
}

Error Responses

status
string
Indicates whether the call was successful. error if not successful.
code
string
The error code indicating the reason for failure. Possible values:
  • UNAUTHORIZED: The user is not authenticated or lacks sufficient permissions.
  • FORBIDDEN: The user does not have permission to access the application.
  • APP_NOT_FOUND: The specified application does not exist.
  • PLAN_RESTRICTED_FEATURE: The user’s plan does not support file manager access.
  • MISSING_PATH_OR_DESTINATION: The path or destination query parameter was not provided.
  • FORBIDDEN_PATH: The specified source path is restricted.
  • FILE_MOVE_FAILED: Failed to move the file or folder.
{
  "status": "error",
  "code": "UNAUTHORIZED"
}