Update documentation content

2026-03-15 05:32:05 +01:00
parent 7d10f030f3
commit c0b92596ec
30 changed files with 1840 additions and 29 deletions
@@ -0,0 +1,56 @@
+---
+title: API Media DELETE | Datasquirel docs
+description: Delete a media file via the Datasquirel API
+page_title: Media DELETE
+page_description: Delete a media file from your Datasquirel media storage using the API.
+---
+
+## Overview
+
+Use the Media DELETE endpoint to permanently remove a file from your media storage. Provide the file's database ID to identify which file to delete.
+
+## npm Package
+
+```javascript
+import datasquirel from "@moduletrace/datasquirel";
+
+const result = await datasquirel.media.delete({
+    mediaID: 23,
+    apiKey: process.env.DATASQUIREL_API_KEY,
+});
+
+console.log(result.success); // true
+```
+
+## Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `mediaID` | `string \| number` | Yes | The database ID of the file to delete |
+| `apiKey` | `string` | No | API key. Falls back to `DATASQUIREL_API_KEY` |
+
+## REST API
+
+```
+DELETE /api/v1/media/{id}
+```
+
+**Headers:**
+```
+Authorization: Bearer YOUR_API_KEY
+```
+
+## Response
+
+```json
+{
+    "success": true,
+    "payload": { "id": 23 }
+}
+```
+
+## Notes
+
+- A **Full Access** API key is required. Read-only keys cannot delete files.
+- Deletion is permanent. The file and its thumbnail are both removed from storage.
+- Use the [Media GET](/docs/api-reference/media/get) endpoint to look up a file's ID before deleting.