Delete Files

Delete a single file or multiple files at once.

Dashboard: Delete

1. Log in to atiru.io.
2. Go to Files.
3. Click the delete (trash) icon next to a file.
4. Confirm the deletion.

For bulk delete, select multiple files and use the bulk delete action (if available).

API: Delete single file

Endpoint: DELETE /files/:id

Replace :id with the file's file_id.

curl

curl -X DELETE "https://api.atiru.io/files/abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

await fetch(`https://api.atiru.io/files/${fileId}`, {
  method: 'DELETE',
  headers: { 'Authorization': `Bearer ${API_KEY}` },
})

Python

requests.delete(
    f'https://api.atiru.io/files/{file_id}',
    headers={'Authorization': f'Bearer {API_KEY}'},
)

Response (204) — No body. File is deleted.

Response (404) — File not found or not owned by you.

Response (403) — Trial ended; upgrade to delete files.

API: Bulk delete

Endpoint: POST /files/bulk-delete

Request body

{
  "ids": ["file_id_1", "file_id_2", "file_id_3"]
}

Maximum 100 IDs per request.

curl

curl -X POST "https://api.atiru.io/files/bulk-delete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids":["abc123","def456"]}'

JavaScript

const res = await fetch('https://api.atiru.io/files/bulk-delete', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ ids: ['abc123', 'def456'] }),
})
const { deleted, errors } = await res.json()

Python

res = requests.post(
    'https://api.atiru.io/files/bulk-delete',
    headers={
        'Authorization': f'Bearer {API_KEY}',
        'Content-Type': 'application/json',
    },
    json={'ids': ['abc123', 'def456']},
)
data = res.json()
print(f"Deleted: {data['deleted']}")

Response (200)

{
  "deleted": 2,
  "errors": [
    {
      "id": "nonexistent",
      "error": "File not found"
    }
  ]
}

deleted is the count of successfully deleted files. errors lists any IDs that could not be deleted (e.g. not found, not owned by you).