Bulk Delete Users

DELETE {{baseUrl}}/api/v2/users/destroy_many?ids=<string>&external_ids=<string>

Accepts a comma-separated list of up to 100 user ids.

The request takes an ids or an external_ids query parameter.

Allowed for

  • Admins

Response

This endpoint returns a job_status JSON object and queues a background job to do the work. Use the Show Job Status endpoint to check for the job's completion.

Request Params

KeyDatatypeRequiredDescription
idsstringId of the users to delete. Comma separated
external_idsstringExternal Id of the users to delete. Comma separated

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;job_status&quot;:{&quot;id&quot;:&quot;82de0b044094f0c67893ac9fe64f1a99&quot;,&quot;message&quot;:&quot;Completed at 2018-03-08 10:07:04 +0000&quot;,&quot;progress&quot;:2,&quot;results&quot;:[{&quot;action&quot;:&quot;delete&quot;,&quot;id&quot;:244,&quot;status&quot;:&quot;Deleted&quot;,&quot;success&quot;:true},{&quot;action&quot;:&quot;delete&quot;,&quot;id&quot;:245,&quot;status&quot;:&quot;Deleted&quot;,&quot;success&quot;:true}],&quot;status&quot;:&quot;completed&quot;,&quot;total&quot;:2,&quot;url&quot;:&quot;https://example.zendesk.com/api/v2/job_statuses/82de0b0467893ac9fe64f1a99.json&quot;}}