Skip to main content

​
Delete File

Permanently delete a file from your storage. This action cannot be undone.

​
Endpoint

DELETE /files/{fileId}

​
Path Parameters

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to delete

​
Example Request

curl -X DELETE "https://api.astracollab.app/v1/files/file_1234567890abcdef" \
  -H "Authorization: Bearer your-api-key-here"

​
Response

{
  "success": true,
  "data": {
    "message": "File deleted successfully",
    "fileId": "file_1234567890abcdef",
    "deletedAt": "2024-01-15T10:30:00Z"
  }
}

​
Error Responses

​
File Not Found

{
  "success": false,
  "error": {
    "code": "FILE_NOT_FOUND",
    "message": "File with ID 'file_1234567890abcdef' not found"
  }
}

​
Access Denied

{
  "success": false,
  "error": {
    "code": "ACCESS_DENIED",
    "message": "You don't have permission to delete this file"
  }
}

​
File in Use

{
  "success": false,
  "error": {
    "code": "FILE_IN_USE",
    "message": "File is currently being used and cannot be deleted",
    "details": {
      "reason": "Active download session"
    }
  }
}

​
Bulk Delete

To delete multiple files at once, use the bulk delete endpoint:

​
Endpoint

DELETE /files/bulk

​
Request Body

{
  "fileIds": [
    "file_1234567890abcdef",
    "file_0987654321fedcba",
    "file_abcdef1234567890"
  ]
}

​
Response

{
  "success": true,
  "data": {
    "deleted": [
      "file_1234567890abcdef",
      "file_0987654321fedcba"
    ],
    "failed": [
      {
        "fileId": "file_abcdef1234567890",
        "reason": "File not found"
      }
    ],
    "deletedAt": "2024-01-15T10:30:00Z"
  }
}

​
SDK Examples

curl -X DELETE "https://api.astracollab.app/v1/files/file_1234567890abcdef" \
  -H "Authorization: Bearer your-api-key-here"

​
Confirmation Dialog

It’s recommended to show a confirmation dialog before deleting files: 
const deleteFileWithConfirmation = async (fileId, fileName) => {
  const confirmed = confirm(`Are you sure you want to delete "${fileName}"? This action cannot be undone.`);
  
  if (confirmed) {
    try {
      await deleteFile(fileId);
      console.log('File deleted successfully');
    } catch (error) {
      console.error('Failed to delete file:', error);
    }
  }
};

​
Soft Delete

Some files may be soft-deleted (moved to trash) instead of being permanently deleted. Check your organization settings for this behavior.

​
Recovery

Soft-deleted files can be recovered within 30 days: 
// Recover a soft-deleted file
await client.files.recover('file_1234567890abcdef');

​
Storage Impact

Deleting files will immediately free up storage space and reduce your usage quota.