Skip to content
Updawg

`DELETE /v1/me`: erase the caller (DAWG-170).

DELETE
/v1/me
curl --request DELETE \
  --url https://api.updawg.net/v1/me \
  --header 'Content-Type: application/json' \
  --data '{ "confirm": "example" }'

Anonymize-and-keep: their name and address are replaced, every way of signing in is removed, and they leave every organization; what they did stays in each organization’s record under “Former member”. See db::erasure for exactly what is kept. Refused while they are the only owner of an organization (sole-owner), and only in person: a session, never an API token.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json

What DELETE /v1/me needs: the caller’s own address, typed back.

object
confirm
required

The email address of the account being erased, exactly as it is. The one thing a stray click, a stolen CSRF token or a confused client cannot supply by accident.

string
Examplegenerated
{
  "confirm": "example"
}

Responses

Section titled “Responses”

204

Section titled “204”

Erased. The session cookie is cleared; nothing can sign in as this account again.

400

Section titled “400”

confirm is not this account’s email address.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

401

Section titled “401”

No session.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

403

Section titled “403”

The CSRF token is missing or wrong.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

409

Section titled “409”

sole-owner: the caller is the only owner of an organization. Make somebody else an owner, or delete the organization, first.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}