Skip to main content
DELETE
/
files
/
{file_id}
Delete File
curl --request DELETE \
  --url https://api.invaro.ai/api/v1/files/{file_id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "file_id": "72f574a0-b3d2-4a0f-8527-f542e6ea7500",
    "message": "File deleted successfully"
  }
}

​
Delete File

DELETE /files/{file_id} Permanently delete a file from the system. This operation removes the file completely and cannot be undone.

​
Features

  • Permanently deletes the file
  • File completely removed from system
  • Cannot be undone - use with caution
  • User ownership validation

​
Parameters

ParameterTypeRequiredDescription
file_idstringYesUnique identifier of the file to delete

​
Request

curl -X DELETE "https://api.invaro.ai/api/v1/files/72f574a0-b3d2-4a0f-8527-f542e6ea7500" \
  -H "Authorization: Bearer your_api_key"

​
Response

{
  "success": true,
  "data": {
    "file_id": "72f574a0-b3d2-4a0f-8527-f542e6ea7500",
    "message": "File deleted successfully"
  }
}

​
Response Fields

FieldTypeDescription
file_idstringID of the deleted file
messagestringConfirmation message

​
Important Notes

  • Irreversible: Deletion cannot be undone
  • Permanent Deletion: File is completely removed from the system
  • No Recovery: File cannot be recovered after deletion
  • Complete Removal: All file data and metadata are permanently deleted

​
Error Responses

  • 404 Not Found: File doesn’t exist or user doesn’t have access
  • 409 Conflict: File is already deleted
  • 403 Forbidden: User doesn’t own the file

​
Try It Out

Use the interactive playground above to test the delete file endpoint. You can:
  1. Add your API key in the Authorization header
  2. Enter a file ID in the path parameter (use a UUID from your uploaded files)
  3. Execute the request to permanently delete the file
⚠️ Warning: This operation cannot be undone. The file will be permanently removed from the system.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
file_id
string<uuid>
required

Unique identifier of the file

Response

200 - application/json

File deleted successfully

​
success
boolean
Example:

true

​
data
object