First-request guide for Delete user using external user id.
Delete user using external user id
Delete user using external user id
Overview
Overview Deletes an existing user from your Demandbase account.
Call the endpoint
Send a DELETE request to /admin/v1/user/{id} with the required authentication and parameters.
Quickstart
Follow these two steps to make a request and recognize a successful response.
Make a request
curl --request DELETE \
--url https://uapi.demandbase.com/admin/v1/user/example \
--header "Authorization: Bearer $DB_API_KEY"Request anatomy
Build the request from the method, path, parameters, and payload described below.
Parameters
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Required | An external client defined identifier for the user (set when creating the user) Example: dcb34525-2baa-4f54-8c11-9e6175ecbc74 |
Request body
This endpoint does not define a JSON request body.
Response anatomy
The endpoint returns 204 for the documented success case. Returned if the user is successfully deleted.
The response schema does not enumerate fields; inspect the example response and status code.
Rules
- Use
DELETEwith the path/admin/v1/user/{id}. - Required inputs: id.
- Authenticate every request with a valid Demandbase access token.
- This endpoint does not require a JSON request body.
Filters
The published schema exposes the following endpoint inputs. Use the location column to place each value correctly.
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Required | An external client defined identifier for the user (set when creating the user) Example: dcb34525-2baa-4f54-8c11-9e6175ecbc74 |
Errors
Handle non-success responses explicitly so your integration can report actionable failures.
| Status | Meaning |
|---|---|
400 | Returned if the user specification in the request body does not match the required format. |
401 | Returned if the authentication credentials are missing or invalid. |
403 | Returned if the authenticated user lacks the "User Management" permission |
404 | Request failed. |
500 | Returned if there was an issue on the server side and user could not be deleted. |