Skip to main content

​
Delete Pixel

Permanently delete a tracking pixel and its associated analytics data.

​
Endpoint

DELETE /api/pixels/{pixelId}

​
Headers

​
Authorization
string
required
Bearer token for authentication

​
Path Parameters

​
pixelId
string
required
Pixel UUID

​
Response

​
success
boolean
Returns true if deletion was successful

​
Example Request

curl -X DELETE "https://your-umami-instance.com/api/pixels/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Example Response

{
  "success": true
}

​
Error Responses

​
401
error
Unauthorized - You don’t have permission to delete this pixel
​
404
error
Not Found - Pixel does not exist
This action is permanent and cannot be undone. The pixel will stop tracking immediately, and all associated analytics data will be deleted.
You must have delete permissions for the pixel to remove it.

Build docs developers (and LLMs) love

Get started for freeTalk to us