Update Shareholder
PUTTag: api-baas-update-shareholderDescription: Update shareholder information. Only provided fields will be updated./v1/users/shareholders/:id
Request
Path Parameters
Shareholder ID.
Header Parameters
The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.
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.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.
- application/json
Body
required
Shareholder full name.
Participation percentage in company capital. Range: 0.00 to 100.00.
Possible values: [PARTNER, ATTORNEY, ADMINISTRATOR, OTHER]
Shareholder type/qualification.
Zip code (CEP) of the shareholder address.
Responses
- 200
- 400
- 401
- 403
- 422
The shareholder updated successfully.
- application/json
- Schema
- Example (from schema)
Schema
Shareholder ID.
Document number (CPF or CNPJ).
Possible values: [NATURAL_PERSON, LEGAL_PERSON]
Person type (PF or PJ).
Shareholder name.
Participation percentage in company capital.
Possible values: [PARTNER, ATTORNEY, ADMINISTRATOR, OTHER]
Shareholder type/qualification.
Zip code (CEP) of the shareholder address.
Creation date.
Update date.
{
"id": "d13ca8f2-4f0a-4a3d-b81e-5ee9c8bb8c56",
"document": "02465676008",
"person_type": "NATURAL_PERSON",
"name": "João Silva",
"participation_percentage": 35.5,
"type": "PARTNER",
"zip_code": "01310100",
"created_at": "2026-01-23T18:06:52.873Z",
"updated_at": "2026-01-23T18:06:52.873Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If the authenticated user does not have permission.
If any required params are missing or has invalid format or type.