Delete a guest account.

DELETE

/api/admin/guest-users/{id}

Code sample: Shell / cURL

curl --request DELETE \
  --url https://auth.example.com/api/admin/guest-users/example \
  --header 'Authorization: Bearer <token>'

Accepts or resumes one guest deletion request across bounded pages. A new legal hold can pause the original request until erasure starts; active holds return 409. A 503 guest_deletion_pending response with Retry-After means the same request is still running. Success is returned only after Core erasure, the minimal PII deny marker, and authentication-state proof are confirmed. Upgrade history is preserved under its existing retention policy.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Path Parameters

id

required

string

Guest account id.

Responses

200

Guest account deletion response.

Media type application/json

object

success

required

boolean

deleted_user_id

required

string

note

required

string

key

additional properties

Example ^generated

{
  "success": true,
  "deleted_user_id": "example",
  "note": "example"
}

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

404

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

409

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

503

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}