DELETE account/delete | ExpoPlatform Helpdesk

DELETE `/api/v2/account/delete`

Removes a single participant account — either permanently from the system, or only from a specific event while keeping the account intact.

Authentication

Authorization: Bearer <your_api_key>

Endpoint

DELETE /api/v2/account/delete

Hard Delete vs Event Detachment

Mode	How to trigger	What happens
Hard delete	Omit `from_event`, or pass `from_event=false`	The account is permanently removed from the system
Event detachment	Pass `from_event=true` with `event_id`	The account is unregistered from the event only. The account continues to exist globally

Query Parameters

At least one of id, email, or external_id must be provided.

Parameter	Type	Required	Accepted Values / Format	Description
`id`	integer	Conditional	Valid account ID	Internal account ID. Tried first when provided
`email`	string	Conditional	Valid email address	Account email. Used as fallback when `id` is not provided
`external_id`	string	Conditional	Any string	Account External ID. Used as fallback when `id` is not provided
`from_event`	boolean	No	`true` / `false`	When `true`, only detaches the account from the event. Requires `event_id`
`event_id`	integer	Required when `from_event=true`	Valid event ID	The event to detach the account from

Response

Hard delete (HTTP 200)

JSON

{
  "code": 200,
  "data": {
    "id": 12345,
    "status": "deleted"
  },
  "response_id": "1700000000.12345"
}

Event detachment (HTTP 200)

JSON

{
  "code": 200,
  "data": {
    "id": 12345,
    "status": "Account removed from event with ID 7 succesfully"
  },
  "response_id": "1700000000.12345"
}

Error Responses

HTTP Code	Condition	Error Message
400	No identifier provided	`Invalid Data`
400	`id` provided but no matching account found	`Invalid Account ID`
400	`external_id` provided but no matching account found	`Invalid External ID`
400	`email` provided but no matching account found	`Invalid Account Email`
400	`event_id` is not a valid integer	`Param must be a integer: event_id`
400	Event not found	`Could not find an event with id = {event_id}`
400	Account is not registered for the event	`Account does not belong to this event`
403	Missing or invalid API key	`Forbidden`

Example Request — hard delete by ID

Bash

curl -X DELETE "https://your-event-domain.com/api/v2/account/delete?id=12345" \
  -H "Authorization: Bearer your_api_key_here"

Example Request — event detachment by email

Bash

curl -X DELETE "https://your-event-domain.com/api/v2/account/delete?email=john.doe@example.com&from_event=true&event_id=7" \
  -H "Authorization: Bearer your_api_key_here"