Delete Item

Delete one or many files or folders within File Request.

Endpoint

DELETE /api/v1/requests/{file_request_id}/items

Parameters

Path parameters

Parameter	Type	Required	Description
file_request_id	string	yes	-

Body parameters

Parameter	Type	Required	Description
items	array	yes	The array of the items
items.*.force_delete	boolean	yes	Determine how to delete the item. If value is set to yes, then the item will be immediately deleted from the database and storage. If false, the item will be softly deleted.
items.*.type	string	yes	The type of the deleting item. Allowed types are folder or file.
items.*.id	uuid	yes	The ID of the item.

Request example

cURL

curl --location --request DELETE 'https://files.ro/api/v1/requests/{file_request_id}/items' \
--header 'Content-Type: application/json' \
--data-raw '{
  "items": [
    {
      "force_delete": false,
      "type": "image",
      "id": "{item_id}"
    }
  ]
}'

Response

200 OK

{
  "type": "success",
  "message": "Items was successfully deleted."
}

403 Forbidden

{
  "type": "error",
  "message": "Access Denied"
}

422 Unprocessable Entity

{
  "message": "The given data was invalid.",
  "errors": {
    "field": [
      "The field is required."
    ]
  }
}