Delete Media Item¶

This endpoint permanently deletes a media item and all its associated data.

Endpoint¶

DELETE https://api.wickson.ai/v1/media/{media_id}

Request¶

Path Parameters¶

Parameter	Type	Description
`media_id`	String	Required. The unique identifier of the media item to delete.

Headers¶

Header	Value	Description
`X-Api-Key`	`YOUR_API_KEY`	Required. Your API key for authentication.

Example Request¶

# Delete a specific media item
curl -X DELETE \
  "https://api.wickson.ai/v1/media/doc_b1e01882-a58c-5010-a13c-ceff0c564f15" \
  -H "X-Api-Key: YOUR_API_KEY"

Python Example¶

import requests

# Configuration
api_key = "YOUR_API_KEY"
media_id = "doc_b1e01882-a58c-5010-a13c-ceff0c564f15"

# Delete the media item
response = requests.delete(
    f"https://api.wickson.ai/v1/media/{media_id}",
    headers={"X-Api-Key": api_key}
)

# Process response
if response.status_code == 200:
    result = response.json()["data"]

    print(f"Media ID: {result['media_id']}")
    print(f"Status: {result['deletion_status']}")
    print(f"Successful: {result['successful']}")
    print(f"Deletion time: {response.json()['metadata']['deletion_time']}")
elif response.status_code == 404:
    print(f"Media item {media_id} not found")
else:
    print(f"Error {response.status_code}: {response.text}")

Response¶

{
  "success": true,
  "message": "Media item deleted successfully",
  "data": {
    "media_id": "doc_b1e01882-a58c-5010-a13c-ceff0c564f15",
    "deletion_status": "completed",
    "successful": true
  },
  "metadata": {
    "deletion_time": "2025-03-09T21:55:10.466986",
    "resource_type": "media_item",
    "processing_time_ms": 285
  },
  "timestamp": "2025-03-09T21:55:10.466986"
}

Response Fields¶

Field	Description
`media_id`	The unique identifier of the deleted media item.
`deletion_status`	Status of the deletion operation.
`successful`	Boolean indicating whether the deletion was successful.

Error Responses¶

Status Code	Description
400	Bad Request - Invalid parameters.
401	Unauthorized - Invalid API key.
403	Forbidden - Insufficient permissions.
404	Not Found - Media item not found.
429	Too Many Requests - Rate limit exceeded.
500	Internal Server Error - Something went wrong on our end.

Example Error Response¶

{
  "success": false,
  "message": "Media item not found",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": {
      "resource_type": "media_item",
      "resource_id": "doc_b1e01882-a58c-5010-a13c-ceff0c564f15"
    }
  }
}

Usage Notes¶

Deletion is permanent and CANNOT be undone. We don't store backups of your original files or processed media items so please be careful with deletion.
All associated data, including vectors, metadata, and content, is permanently removed
Account for deletion in your applications by updating any references to deleted media items
Batch operations are available for deleting multiple media items efficiently (see Batch API documentation)
Consider archiving important content before deletion by retrieving it with the Get Media Item endpoint

Security Considerations¶

Ensure your API key has the appropriate permissions for deletion operations
Consider implementing confirmation steps in your application before triggering deletion
Audit logs for deletion operations are available in your account dashboard