Skip to main content

Move Media Files

PUThttps://api.perceptpixel.com/v1/media/:uid/move

Moves the media file into the specified Folder.

Path Parameters​

  • :uid - The unique identifier of the media item.

Request Body​

  • folder_name - The name of the destination folder.

Response (200)​

{
    "status": "success"
}

Response (4xx/5xx)​

warning

The data format of the error response is not yet finalized. Please only check the status code at the moment.

{"field":["error message"]}

Example

{"folder_name": ["Please specify destination folder name"]}

Example (curl)​

# Replace {API_KEY} with your actual API key, without enclosing it in curly braces
# Replace {MEDIA_UID} with the unique identifier of the media file, without enclosing it in curly braces
# Replace {FOLDER_NAME} with the name of the destination folder, without enclosing it in curly braces

curl "https://api.perceptpixel.com/v1/media/{MEDIA_UID}/move" \
-X PUT \
  -H "Authorization: Api-Key {API_KEY}" \
  -d 'folder_name={FOLDER_NAME}'