Billing

Delete the current account

Permanently deletes the authenticated account. An existing session is not sufficient: the caller must present a single-use step-up token from a fresh re-authentication or email code. The API then cancels every live Stripe subscription (an account that Stripe can still charge is never deleted), revokes connector grants, gives each shared revenue workspace to another member, deletes all account data, revokes identity-provider sessions, and deletes the WorkOS identity.

delete/v1/me

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /v1/me
Auth: HTTP bearer

Request body

confirm'DELETE' required

Must be the literal value DELETE.

stepUpTokenstring required

Single-use proof from POST /v1/me/deletion-challenges/{id}/verify. Typing DELETE does not satisfy this.

Example request

{
  "confirm": "DELETE",
  "stepUpToken": "dG9rZW4"
}

Response

Account deleted. The receipt records what the deletion did.

completedAtstring required

When the deletion finished (RFC 3339).

connectorsRevokedinteger required

Connector grants revoked.

identityDeletedboolean required

Whether the WorkOS identity was deleted. False means support must delete it.

receiptIdstring required

Receipt identifier for support.

requestedAtstring required

When the deletion started (RFC 3339).

subscriptionsCancelledinteger required

Stripe subscriptions cancelled.

workspacesDeletedinteger required

Workspaces deleted with the account.

workspacesTransferredinteger required

Shared workspaces given to another member.

Example response

{
  "completedAt": "2026-09-15T10:00:02Z",
  "connectorsRevoked": 2,
  "identityDeleted": true,
  "receiptId": "5d0f7c1e-2a8b-4c1d-9f3e-7b6a5c4d3e2f",
  "requestedAt": "2026-09-15T10:00:00Z",
  "subscriptionsCancelled": 1,
  "workspacesDeleted": 1
}

Changes

No operation changes recorded.