Skip to content

DELETE/photos/{id}

Delete photo

Permanently remove a photo. Returns deleted resource. Triggers `photos.deleted` webhook.

Parameters 1

NameTypeDescription
idrequiredpath · integerResource identifier

ReturnsPhoto

Bearer token required

Response examples

200Deleted photo

application/json example derived from schema

{
  "id": 1,
  "albumId": 1,
  "title": "Photo 1",
  "url": "https://picsum.photos/seed/1/800/960",
  "thumbnailUrl": "https://picsum.photos/seed/1/150/150",
  "width": 800,
  "height": 960,
  "size": 4803273,
  "format": "jpeg",
  "createdAt": "2026-07-24T20:47:13.121Z"
}
404404 — resource not found

application/json

{
  "error": {
    "status": 404,
    "message": "users #999 not found"
  }
}

Released under the MIT License.