Delete exported photos · Photo Collect API

Permanently remove successfully downloaded photos and mark their records as received.

Call this endpoint only after each file has been downloaded, validated, and safely persisted. Photo Collect changes photo_status to received and permanently removes the image from the export directory.

Once a record is received, personally identifiable invitation data—including contact, customer number, uploader OS, and IP—is removed after the configured retention period relative to the invitation expiry date.

Request parameters

Parameter	Required	Description
`invitation_key`	Yes	One to 100 exported invitation keys. Arrays use `invitation_key[]`.

The legacy JSON body { "invitation_keys": ["Kuz1pfIG", "mExcxiPk"] } is also supported when no query filter is supplied. The same 100-key limit applies. Split larger lists into separate requests; an oversized request returns HTTP 400 with BATCH_SIZE_EXCEEDED before any files are deleted.

Deletion includes the primary image, its variants, and its signature when signatures are enabled. If a file cannot be removed, the key returns error and the invitation remains available for retry. Files already removed are tolerated on retry.

Response

Each submitted key maps to its outcome:

{
  "Kuz1pfIG": "deleted",
  "mEcxiPxk": "not found",
  "cxiPKuzQ": "error"
}

Missing parameters return HTTP 400 with DELETE_FAILED.