Remove an organization user

Request#

DELETE /api/v1/users/{user}

Requires users:delete. See token permissions. The token creator must remain an active administrator of the token’s organization.

Send Authorization: Bearer YOUR_API_TOKEN and Accept: application/json.

user is the numeric ID of a current member of the token’s organization. This is a login user, distinct from an inventory person.

Query parameters#

This endpoint does not use query parameters.

Request body#

No request body is supported.

Requires Idempotency-Key. Use a unique key for each action and keep it unchanged when retrying. Successful responses are remembered for 24 hours per token. Idempotency and retries.

Example#

Set ASSETCENTER_API_TOKEN as described in the quick start. Replace example IDs with values from your organization.

curl --request DELETE "https://my.assetcenter.app/api/v1/users/42" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: $(uuidgen)"

Response#

200 OK. Illustrative response; IDs and values will differ.

{
  "data": {
    "user_id": 42,
    "removed": true,
    "account_deleted": false
  }
}

Behavior and constraints#

Removes this organization’s membership, category restrictions, pending invitations for the user’s email, and customer integration tokens issued by that user for this organization. The token creator cannot be removed, and the organization must retain an active administrator.

The user account is preserved, including when this was their only organization. Other memberships and tokens remain unchanged. If this organization was selected in the user’s app, another remaining organization is selected, or the selection becomes empty. This is membership removal, not global account deletion.

A retry with the original Idempotency-Key replays the success even though membership has already been removed. A new key for the removed membership returns 404.

Errors#

401 means the customer bearer token is missing, expired, revoked, or invalid. 403 means the token lacks the required permission or its creator is no longer an active administrator. 404 means the requested member or invitation is unavailable in this organization. 422 identifies invalid or unsupported input, plan limits, or a protected membership change. 409 indicates conflicting key reuse or a concurrent organization change. 429 means a rate limit was reached. Error handling and rate limits.