DeleteProfile

POST /v1/profiles/{id}/delete: the preview the confirmation was shown over, echoed back whole. A preview whose targets or revision no longer match is refused with idempotency_conflict (HTTP 409): a materially destructive confirmation taken over a changed list requires a refresh.

Type object

Shape

Field	Type	Description
previewrequired	ProfileDeletionPreview	What a Profile deletion would trash right now, with a revision the caller echoes back so a confirmation taken over a stale list is refused.

Example

{
  "preview": {
    "targets": [
      "00000000-0000-4000-8000-000000000000"
    ],
    "placement_revision": 0
  }
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

POST/v1/profiles/{id}/delete
Delete a Profile as a shared batch: the Profile and every captured workspace move to Trash in one transaction

Generated from contract version 1. Last updated November 12, 2026.