Skip to content

Request withdrawal of the authenticated mother's own account

POST
/mother/account-withdrawals
curl --request POST \
--url https://example.com/mother/account-withdrawals \
--header 'Authorization: Bearer <token>' \
--header 'Idempotency-Key: example'

Body-free self command. Supabase bearer identity is resolved server-side; the caller cannot assert account, profile, member, role, branch, retention, audit, or relationship-deletion facts.

Idempotency-Key
required
string
>= 1 characters <= 255 characters /^\S(?:.*\S)?$/

Existing or synchronously completed withdrawal returns a safe receipt

Media typeapplication/json
MotherAccountWithdrawalResult
object
withdrawalReceiptId
required
string
>= 1 characters <= 255 characters /^\S(?:.*\S)?$/
accountLifecycle
required
string
Allowed values: withdrawal_pending withdrawn
profileAccessState
required
Allowed value: revoked
requestedAt
required
string format: date-time
completedAt
required
One of:
string format: date-time
idempotentReplay
required
boolean
key
additional properties

Withdrawal accepted, raw profile access revoked, and server effects pending

Media typeapplication/json
object
withdrawalReceiptId
required
string
>= 1 characters <= 255 characters /^\S(?:.*\S)?$/
accountLifecycle
required
string
Allowed values: withdrawal_pending withdrawn
profileAccessState
required
Allowed value: revoked
requestedAt
required
string format: date-time
completedAt
required
One of:
string format: date-time
idempotentReplay
required
boolean
accountLifecycle
required
Allowed value: withdrawal_pending
idempotentReplay
required

A valid Supabase bearer session is required

Media typeapplication/json
One of:
object
status
required
Allowed value: 401
code
required
Allowed value: authentication_required
retryable
required
key
additional properties

Authenticated actor cannot withdraw a mother account

Media typeapplication/json
One of:
object
status
required
Allowed value: 401
code
required
Allowed value: authentication_required
retryable
required
key
additional properties

No own mother account exists in the authenticated actor scope

Media typeapplication/json
One of:
object
status
required
Allowed value: 401
code
required
Allowed value: authentication_required
retryable
required
key
additional properties

Current own-account lifecycle cannot accept the withdrawal transition

Media typeapplication/json
One of:
object
status
required
Allowed value: 401
code
required
Allowed value: authentication_required
retryable
required
key
additional properties

Idempotency-Key is invalid or a forbidden request body was supplied

Media typeapplication/json
One of:
object
status
required
Allowed value: 401
code
required
Allowed value: authentication_required
retryable
required
key
additional properties

Withdrawal authority or a required server-owned effect is unavailable

Media typeapplication/json
One of:
object
status
required
Allowed value: 401
code
required
Allowed value: authentication_required
retryable
required
key
additional properties