Update User Account by ID
PUT/v2/users/accounts/:id
Update an user account.
Request
Path Parameters
User account ID.
Header Parameters
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.
UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.
- application/json
Body
required
Update user account payload.
- Natural Person
- Legal Person
Responses
- 200
- 400
- 401
- 403
- 409
- 422
User account updated.
- application/json
- Schema
- Example (from schema)
Schema
User account ID.
Possible values: [pending, active, expired, deactivated, deleting]
User state.
User created date.
User updated date.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"state": "active",
"created_at": "2026-03-26T14:02:59.125Z",
"updated_at": "2026-03-26T14:02:59.125Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If the authenticated user does not have permission.
If a user account with the provided document or email or phone number already exists.
If any required params are missing or has invalid format or type.