Skip to navigation

Users Delete

Preview
View as Markdown

Disables up to 100 managed users owned by the authenticated Provider app and schedules their account data for deletion. This is not recoverable. File purge is asynchronous. Failed batches can have partial results; retry the same user selectors to finish deletion. This pilot requires app authentication; tenant credentials are not supported.

Required scope: private:agent_filesystem.users.manage OR private:agent_filesystem.tenant.users.manage

Endpoint format: RPC

Authentication: App

This endpoint does not support apps with the app folder permission.

Authentication

AuthorizationBearer

App-level OAuth 2.0 token (no user context). Use Authorization: Bearer <token>.

Obtain by calling the token endpoint with grant_type=client_credentials.

Only available on endpoints that declare app auth support.

OR
AuthorizationBearer

App-level OAuth 2.0 token (no user context). Use Authorization: Bearer <token>.

Obtain by calling the token endpoint with grant_type=client_credentials.

Only available on endpoints that declare app auth support.

Request

This endpoint expects an object.
userslist of objectsRequired
Users to delete.
Variant:
agent_filesystem.UserSelector.user_public_idobjectRequired
Selects the user by its public user ID for this Provider app.

Response headers

X-Dropbox-Request-IdstringOptional
A unique identifier for the request, useful for debugging and support.

Response

Successful response (no content)

Errors

401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error