Skip to navigation
business.me-mate.net APIs Document V 1.0Messenger Mate Gallery App File Upload Folder Management APIFile Upload Ap Is

Restore File from Trash

View as Markdown

Restore File from Trash

Restores a file that was previously moved to trash.

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

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:

VariableRequiredDescription
base_urlYesBase API URL (e.g. https://business.me-mate.net/partners/wp-gallery/manage)
access_tokenYesAccess token used to authorize the request
file_idYesID of the file to restore

Path Parameters

ParameterTypeRequiredDescription
file_idintegerYesUnique identifier of the file to restore

Example request URL:

{{base_url}}/files/34/restore

Sample request

curl --request POST "{{base_url}}/files/{{file_id}}/restore" \
  --header "Authorization: Bearer {{access_token}}"

Sample success response

A successful request typically returns HTTP 200 OK.

{
  "success": true,
  "message": "File restored 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:17:42.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:17:42.000000Z",
      "deleted_at": null
    }
  }
}

Common errors

  • 400 Bad Request

    • Invalid or missing file_id

  • 401 Unauthorized / 403 Forbidden

    • Missing/invalid Authorization header

    • Expired {{access_token}}

  • 404 Not Found

    • File with the given file_id does not exist

    • File is not in trash

Notes

  • This endpoint restores a soft-deleted file from trash.

  • The file will be returned to its original folder.

  • Once restored, the deleted_at field becomes null, indicating the file is active again.

Response

OK
dataobject
messagestring
successboolean