Skip to content

Delete Item

Delete one or many files or folders within shared folder.

Endpoint

http
DELETE /api/v1/shares/{token}/items

Parameters

Path parameters

ParameterTypeRequiredDescription
tokenstringyes-

Body parameters

ParameterTypeRequiredDescription
itemsarrayyesThe array of the items to remove.
items.*.force_deletebooleanyesDetermine 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.*.typestringyesThe type of the deleting item. Allowed types are folder or file.
items.*.iduuidyesThe ID of the item.

Request example

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

Response

json
{
  "type": "success",
  "message": "Items was successfully deleted."
}
json
{
  "type": "error",
  "message": "Access Denied"
}