logo
UsersDelete user

Delete user

Removes a user from the company by ID.

Rules:

  • userId must be a valid v4 UUID for a user in the company.
  • The primary (MAIN) user cannot be deleted.
curl -X DELETE "https://api-sandbox.contasimples.com/users/v1/users/550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{}
DELETE
/users/v1/users/{userId}
DELETE
Bearer Token
Bearer Tokenstring
Required

Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}

Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}
path
userIdstring
Required

User ID to remove (v4 UUID).

Format: uuid
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}

Path Parameters

userIdstring
Required

User ID to remove (v4 UUID).

Responses