Update legal representative
PUT/v1/users/legal-representatives/:id
Update a legal representative information.
Request
Path Parameters
Legal representative 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.
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
Legal representative full name.
Income in cents.
Patrimony in cents.
Participation percentage (0 to 100).
PEP self-declaration.
Possible values: [PARTNER, ATTORNEY, ADMINISTRATOR, OTHER]
Legal representative qualification.
Phone number.
Email.
Relationship start date with the legal entity.
Relationship end date with the legal entity.
address object
User address zip code.
User address street.
User address number.
User address neighborhood.
User address neighborhood.
User address federative unit.
User address country.
User address complement.
Responses
- 200
- 400
- 401
- 403
- 422
Legal representative updated.
- application/json
- Schema
- Example (from schema)
Schema
Legal representative ID.
document objectrequired
Document ID.
Possible values: [CPF]
Document type.
Document number.
Document country of issue.
address objectrequired
Address ID.
ZIP code.
Street.
Street number.
Neighborhood.
City.
Federative unit.
Country.
Address complement.
Legal representative name.
Possible values: [PARTNER, ATTORNEY, ADMINISTRATOR, OTHER]
Legal representative qualification.
Possible values: [NATURAL_PERSON, LEGAL_PERSON]
Person type.
Income in cents.
Patrimony in cents.
Participation percentage.
PEP flag.
Public server flag.
Phone number.
Email.
Registration update date.
Birth date.
Relationship start date with the legal entity.
Relationship end date with the legal entity.
Creation date.
{
"id": "d13ca8f2-4f0a-4a3d-b81e-5ee9c8bb8c56",
"document": {
"id": "a1df6c59-359d-4ec1-b7da-98dcc555dd76",
"type": "CPF",
"number": "02465676008",
"country_of_issue": "BRA"
},
"address": {
"id": "7b5e8c47-b6a3-4e29-942f-7f5ec06b26a2",
"zip_code": "60123456",
"street": "Main Street",
"number": 123,
"neighborhood": "Downtown",
"city": "São Paulo",
"federative_unit": "SP",
"country": "BRA",
"complement": "Apt 12"
},
"name": "Jane Doe",
"representor_type": "PARTNER",
"person_type": "NATURAL_PERSON",
"income": 100000,
"patrimony": 5000000,
"participation_percentage": 35.5,
"pep": false,
"is_public_server": false,
"phone_number": "5511955551234",
"email": "partner@example.com",
"registration_update_date": "2024-02-01",
"birth_date": "1980-01-15",
"relationship_start_date": "2020-05-01",
"relationship_end_date": "2024-01-01",
"created_at": "2025-12-12T22:44:48.066Z"
}
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.