Move File to Folder

Move File to Folder

Moves a file from its current folder to another folder.

Method: POST
URL: {{base_url}}/files/{{file_id}}/move

Authentication

This endpoint requires authentication.

• Recommended: Bearer token in the Authorization header:

Authorization: Bearer {{access_token}}

Notes:

• If your collection/folder already sets auth, this request can inherit auth.

• Ensure {{access_token}} is a valid, non-expired token.

Required variables

Set these variables at the environment or collection level:

Path Parameters

Example request URL:

{{base_url}}/files/34/move

Body (raw JSON)

Send the request body as raw JSON.

Example body:

{
  "folder_id": 9
}

Notes:

• The file will be removed from its current folder and assigned to the new folder.

• The folder_id must belong to a folder that exists and is accessible to the authenticated user.

Sample request

curl --request POST "{{base_url}}/files/{{file_id}}/move" \
  --header "Authorization: Bearer {{access_token}}" \
  --header "Content-Type: application/json" \
  --data '{
    "folder_id": 9
  }'

Sample success response

A successful request typically returns HTTP 200 OK.

{
  "success": true,
  "message": "File moved successfully",
  "data": {
    "id": 34,
    "user_id": "43028",
    "folder_id": 9,
    "name": "renamed-photo.png",
    "original_name": "Frame 1000003420.png",
    "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/MEL37P9ilmLodrQg.png",
    "hash": "b302a431204139c0572ab43b0d2bbc71297e8e1c21445d8daa786126de2d1cb1",
    "path_hash": null,
    "mime_type": "image/png",
    "type": "image",
    "extension": "png",
    "size": 87963,
    "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/MEL37P9ilmLodrQg.png",
    "is_starred": false,
    "is_whatsapp_compatible": true,
    "whatsapp_compatibility_reason": "Ready for WhatsApp",
    "uploaded_at": "2026-03-10T04:37:27.000000Z",
    "created_at": "2026-03-10T04:37:27.000000Z",
    "updated_at": "2026-03-10T06:16:27.000000Z",
    "deleted_at": null,
    "tags": [],
    "folder": {
      "id": 9,
      "user_id": "43028",
      "name": "test",
      "parent_id": null,
      "is_system": false,
      "file_count": 1,
      "created_at": "2026-03-09T13:09:49.000000Z",
      "updated_at": "2026-03-10T06:16:27.000000Z",
      "deleted_at": null
    }
  }
}

Common errors

• 400 Bad Request

  • Missing folder_id

  • Invalid folder ID provided

• 401 Unauthorized / 403 Forbidden

  • Missing/invalid Authorization header

  • Expired {{access_token}}

• 404 Not Found

  • File with the given file_id does not exist

  • Destination folder does not exist

Notes

• This endpoint moves a file between folders without changing the file itself.

• The file’s metadata and URL remain unchanged.

• Only the folder_id association is updated.