Files

Move a file to a new location.

Changed on

This endpoint performs an asynchronous move of an existing file asset, identified by its assetId, into another folder or project. The operation requires the requester to have, at minimum, the following roles:

LocationRole(s)
Sourcecomment
Source's parentedit
Targetedit

NOTE:

  • If the requester lacks the required roles or the file does not exist, an appropriate error response will be returned.
post/files/{assetId}/move

Request

  • Base URL: https://cloudstorage.adobe.io/v1
  • URL: https://cloudstorage.adobe.io/v1/files/{assetId}/move
  • Auth: HTTP bearer

Path parameters

assetIdstring required

A globally unique identifier for the asset

Example:urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174

The ID of the asset to get.

Headers

x-request-idstring
Example:1234567890

The X-Request-Id header is used to identify a request.
It can be used to correlate logs and other resources and is intended to be a non-persistent identifier.

Request body

parentIdstring required

A globally unique identifier for the asset

namestring

The name of the asset (including the extension, in case of a file)

The name must not be a

  • reserved Windows name
    • CON
    • PRN
    • AUX
    • NUL
    • COM1 through COM9
    • LPT1 through LPT9
  • contain any of the following characters:
    • \
    • /
    • :
    • *
    • ?
    • "
    • |
    • >
    • <

Example request

{
  "parentId": "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174",
  "options": {
    "autorename": true
  }
}

Response

Accepted - Request to move a file was accepted and will be processed asynchronously.

jobIdstring

A globally unique identifier for the asynchronous job

Changes

  • 240b6278279cRevision changes
    • breaking

      added the pattern ^(?!^([Cc][Oo][Nn]|[Pp][Rr][Nn]|[Aa][Uu][Xx]|[Nn][Uu][Ll]|[Cc][Oo][Mm][1-9]|[Ll][Pp][Tt][1-9])$)[^\\\/:*?"|><]+$ to the request property

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • info

      the request property's minLength was decreased from 1 to 0

  • 01600f5358e9Revision changes
    • info

      endpoint added