Clerk API (unofficial showcase)
DELETE/waitlist_entries/{waitlist_entry_id}

Delete a pending waitlist entry

Deletes a pending waitlist entry. Use the waitlist_entry_id path parameter to identify the entry to delete. Entries locked while a batch action is processing are unavailable for other actions.

1 parameter
waitlist_entry_idstringrequired
The ID of the pending waitlist entry to delete.

5 status codes
200Returns a deletion result with a `deleted` flag and available entry identifiers.
objectstringrequired
idstringoptional
slugstringoptional
deletedbooleanrequired
external_idstringoptional
400Returned when the request is unsuccessful.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Returned when the waitlist entry is not found.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
409Returned when the deletion conflicts with the entry's current state.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
422Returned when request parameters are invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional

Error handling

A 400 is returned when the request is unsuccessful, a 404 when the waitlist entry is not found, and a 409 when the deletion conflicts with the entry's state. A 422 is returned for invalid request parameters. The waitlist_entry_id path parameter must identify the pending waitlist entry to delete.