DELETE account/deleteBulk | ExpoPlatform Helpdesk

DELETE `/api/v2/account/deleteBulk`

Removes all participants from an event in a single operation. Supports both hard deletion (permanently removing accounts from the system) and event detachment (removing participants from the event only, while keeping their accounts). Specific participants can be excluded from the operation.

Authentication

Authorization: Bearer <your_api_key>

Endpoint

DELETE /api/v2/account/deleteBulk

Hard Delete vs Event Detachment

Mode	How to trigger	What happens
Hard delete	Omit `from_event` or pass `from_event=false`	All matched participant accounts are permanently deleted from the system
Event detachment	Pass `from_event=true`	All matched participants are unregistered from the event. Their accounts remain in the system

Query Parameters

Parameter	Type	Required	Accepted Values / Format	Description
`event_id`	integer	Yes	Valid event ID	The event whose participants will be removed
`from_event`	boolean	No	`true` / `false`	When `true`, participants are only detached from the event, not deleted from the system
`except`	string	No	Comma-separated internal account IDs (e.g. `101,202,303`)	Account IDs to skip. These participants will not be removed

Response

Success (HTTP 200)

JSON

{
  "code": 200,
  "data": {
    "id": "101,102,103",
    "status": "Accounts removed from event"
  },
  "response_id": "1700000000.12345"
}

Field	Type	Description
`id`	string	Comma-separated list of successfully removed account IDs
`status`	string	`"Accounts deleted from event"` (hard delete) or `"Accounts removed from event"` (detachment)
`errors`	array	Present only when individual account removals failed

Nothing removed

JSON

{
  "code": 200,
  "data": {
    "id": "",
    "status": "skipped"
  }
}

Error Responses

HTTP Code	Condition	Error Message
400	`event_id` is missing	`Param is required: event_id`
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	No participants found for this event	`There are no participants on this exhibition present in DB`
403	Missing or invalid API key	`Forbidden`

Example Request — detach all participants from event

Bash

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

Example Request — detach all except specific accounts

Bash

curl -X DELETE "https://your-event-domain.com/api/v2/account/deleteBulk?event_id=7&from_event=true&except=101,202" \
  -H "Authorization: Bearer your_api_key_here"