V2UpdateLegalRepresentativeRestBody

name string

Legal representative name.

mother_name string

Mother name.

income number

Income in cents.

patrimony number

Patrimony in cents.

participation_percentage number

Participation percentage in management/representation (0 to 100).

Note: This represents the legal representative's participation in company management, which may differ from their equity stake. If this legal representative is linked to a shareholder, the shareholder has its own participation_percentage representing equity stake.

pep boolean

PEP self-declaration.

representor_type string

Possible values: [PARTNER, ATTORNEY, ADMINISTRATOR, OTHER]

Legal representative qualification.

phone_number string

Phone number.

email string

Email.

relationship_start_date date-time

Relationship start date with the legal entity.

relationship_end_date date-time

Relationship end date with the legal entity.

shareholder_id string

Shareholder ID to link this legal representative to. Must belong to the same company.

Usage:

• Link: Provide a valid shareholder UUID to link the representative
• Relink: Provide a different shareholder UUID to change the link
• Unlink: Omit this field completely to remove the shareholder link (if currently linked)

Note: The shareholder must be created first via the shareholders endpoint and must belong to the same company.

To unlink: Simply omit this field from the request body. The system will automatically remove the link if one exists.

address object

zip_code stringrequired

User address zip code.

street stringrequired

User address street.

number numberrequired

User address number.

neighborhood string

User address neighborhood.

city stringrequired

User address city.

federative_unit stringrequired

User address federative unit.

country stringrequired

User address country.

complement string

User address complement.