TracePass
Loslegen
Pässe

Pass löschen

Ein zur Löschung markierter Pass → Soft Delete. Ein Pass, der veröffentlicht wurde, wird in zwei Schritten gelöscht: zuerst POST /api/v1/passports/{id}/mark-for-deletion, dann dieses DELETE. Es wird nichts vernichtet: Der Pass verschwindet aus der API (jeder v1-Aufruf dazu antwortet ab dann mit 404) und von allen öffentlichen Oberflächen. Wer den QR-Code scannt, sieht eine Seite mit dem Hinweis, dass der Pass beendet ist, und die maschinenlesbaren Formate antworten mit 410 Gone. Gibt den Pass mit status: "deleted" zurück und sendet den passport.deleted-Webhook.

DELETE/api/v1/passports/{id}
OpenAPI 3.1 herunterladen
DELETE/api/v1/passports/{id}

Pass löschen

Ein zur Löschung markierter Pass → Soft Delete. Ein Pass, der veröffentlicht wurde, wird in zwei Schritten gelöscht: zuerst POST /api/v1/passports/{id}/mark-for-deletion, dann dieses DELETE. Es wird nichts vernichtet: Der Pass verschwindet aus der API (jeder v1-Aufruf dazu antwortet ab dann mit 404) und von allen öffentlichen Oberflächen. Wer den QR-Code scannt, sieht eine Seite mit dem Hinweis, dass der Pass beendet ist, und die maschinenlesbaren Formate antworten mit 410 Gone. Gibt den Pass mit status: "deleted" zurück und sendet den passport.deleted-Webhook.

Ein nie veröffentlichter Pass → endgültiges Löschen. Ein Pass mit Status draft oder in_review und publishedAt: null wird mit allem entfernt, was nur zu ihm gehört: KI-Extraktionen, Scan- und Serviceereignisse, Eigentumsübertragungen, EPCIS-Ereignis-Verknüpfungen sowie hochgeladene Dokumente und gespeicherte Dateien, die kein anderer Datensatz nutzt. Mit anderen Pässen oder Produkten geteilte Dokumente bleiben erhalten, nur die Verknüpfung wird entfernt. Das ist unumkehrbar. Kein Webhook wird ausgelöst; die Löschung wird in der Audit-Spur Ihres Kontos festgehalten. Auf Free-Plänen gibt es 403 Forbidden mit einem reason zurück, der auf POST /api/v1/passports/{id}/archive verweist.

Jeder andere Status → 409 Conflict. Der Body enthält einen hint („A published passport is deleted in two steps: mark it for deletion first.“) und einen reason.

Löschen über die API erfordert einen Bezahlplan. Zählt als ein v1-Schreibvorgang. Unterstützt Idempotency-Key.

Pfad-Parameter

  • iderforderlich

    string (24 hex chars)

    Pass-ID.

Header

  • Authorizationerforderlich

    string

    Bearer <token> — entweder ein tp_ API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

  • Idempotency-Key

    string

    UUID v4.

Anfrage

curl -sS -X DELETE \
  https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Antwort

{
  "_id": "6650b2c3d4e5f6a7b8c9d0e1",
  "status": "deleted",
  "deletedAt": "2026-11-02T09:30:00.000Z",
  "deletedReason": "recycled"
}

Verwandte Endpoints