Bulk delete external users

You can remove up to 100 external users from your enterprise using the API. This API endpoint removes access to all types of content you invited the listed external users to collaborate on. To remove the external users, call .

This endpoint requires API version 2025.0. Include the box-version: 2025.0 header in your request.

curl -i -X POST "https://api.box.com/2.0/external_users/submit_delete_job" \
     -H "box-version: 2025.0" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "external_users": [
         {
           "type": "user",
           "id": "<EXTERNAL_USER_ID>"
         }
       ]
     }'

This job runs in the background, and sends a completion report listing deletion status for each user when it’s finished.

When you delete external users, their pending collaboration invites are not deleted.

Last modified on August 28, 2026

Getting started

Applications & integrations

Identity & access

Using the API

Troubleshooting

Content

Collaboration

Metadata & search

Events & webhooks

Users

Intelligent workflow

E-signatures

Security & compliance

Bulk delete external users