---
title: "Remove a party from a passport."
method: DELETE
path: "/api/v1/passports/{id}/parties/{role}"
tags: ["Passports"]
---

# Remove a party from a passport.

`DELETE /api/v1/passports/{id}/parties/{role}`

## Request

- Base URL: `https://app.tracepass.eu`
- URL: `https://app.tracepass.eu/api/v1/passports/{id}/parties/{role}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://app.tracepass.eu/api/oauth/authorize`, token URL `https://app.tracepass.eu/api/oauth/token`, scopes: `passports:write`)

Remove the Party for one role on a passport. Idempotent —
removing an absent role returns `{ removed: false }`
without bumping the passport version.

## Response `200`

Party removed (or already absent).

- object
  - `role` 'manufacturer' | 'importer' | 'authorisedRepresentative' | 'distributor' | 'recycler' | 'producerResponsibilityOrg', required
  - `removed` boolean, required
  - `version` integer

## Other responses

- `401`: Missing or invalid API key.
- `404`: Resource doesn't exist or is in a different workspace.
- `429`: Daily v1 write or passport-read budget exhausted. Resets at 00:00 UTC.

---

[API](https://skmtc.dev/tracepass/apis/tracepass-api.md) · [All operations](https://skmtc.dev/tracepass/apis/tracepass-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracepass/apis/tracepass-api/revisions/60ddeb25638b?raw)