Skip to content
Updraft Docs
Türkçe

Deletions · API reference

Reporting a pilot deletion request (GDPR/KVKK erasure); flight data is deleted and a tombstone remains.

POST /v1/deletions

Delete a pilot's flights, or the pilot's data altogether (KVKK)

With flight_ids: those flights. Pilot-wide (no flight_ids): every flight of the pilot, the pilot's privacy masks and the link to the client's pilot id. At once: the flights leave every API answer and every new layer computation and their public share links close; within minutes (at the latest the next night) the raw IGC, fix files, videos and thermal events are deleted; within 24 hours every published grid cell and take-off/landing count is recomputed without them. The same file uploaded again is refused (409 flight_deleted). Repeating the request is safe.

Authentication: X-Api-Key header; required scope: scope table.

Request body

application/json → DeletionRequestBody

Responses

StatusDescriptionContent
202Successful Responseapplication/json → DeletionReceiptOut
401code: auth_missing, auth_invalid, auth_revokedapplication/json → ErrorBody
403code: auth_scopeapplication/json → ErrorBody
404code: flight_not_foundapplication/json → ErrorBody
422code: request_invalidapplication/json → ErrorBody
429code: rate_limited, quota_exceeded (Retry-After seconds)
Headers: Retry-After — Seconds until the exhausted window resets
application/json → ErrorBody

GET /v1/deletions/{deletion_id}

Progress of a deletion request

pending until the files of every flight are gone; then completed.

Authentication: X-Api-Key header; required scope: scope table.

Parameters

NameInTypeDescription
deletion_id requiredpathstring (uuid)deletion_id of the request

Responses

StatusDescriptionContent
200Successful Responseapplication/json → DeletionStatusOut
401code: auth_missing, auth_invalid, auth_revokedapplication/json → ErrorBody
403code: auth_scopeapplication/json → ErrorBody
404code: deletion_not_foundapplication/json → ErrorBody
422code: request_invalidapplication/json → ErrorBody
429code: rate_limited, quota_exceeded (Retry-After seconds)
Headers: Retry-After — Seconds until the exhausted window resets
application/json → ErrorBody