Update an individual

patch

https://api.dotfile.com/v1/individuals/{id}

Updates the individual with the given ID.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

uuid

required

Id of the individual

Body Params

first_name

string

middle_name

string | null

May contain multiple middle names

last_name

string

maiden_name

string | null

is_business_contact

boolean

Defaults to false

Set to true if this individual should be contacted regarding the case, this will also make the email required.

is_beneficial_owner

boolean

Defaults to false

Set to true if this individual ultimately owns or controls the main company

is_delegator

boolean

Defaults to false

Set to true if this individual is delegating its signing authority to the signatory of the case.
Individual cannot be both delegator and signatory Not relevant individual cannot be delegator

is_signatory

boolean

Defaults to false

Set to true if this person has delegated authority to be a signatory of the case, this will also make the email required.
Individual cannot be both signatory and delegator Not relevant individual cannot be signatory

string | null

Required if individual is_business_contact is true. Must be a valid email as defined in the HTML spec (eg. must match the following JavaScript-compatible regular expression: /^[a-zA-Z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/)

birth_date

date | null

Date in format ISO 8601(yyyy-MM-dd eg 2023-01-31)

birth_country

string | null

ISO 3166-1 alpha-2 country code (eg FR)

birth_place

string | null

address

object

banking_information

object | null

tax_identification_number

string | null

social_security_number

string | null

phone_number

string | null

E.164 phoneNumber (eg +XXXXXXXXXXX)

position

string | null

ownership_percentage

number | null

0 to 100

voting_rights_percentage

number | null

0 to 100

roles

array of strings

legal_representative shareholder

roles

custom_properties

object

Optional partial custom properties object in a format of key (string) / value (string | boolean | string[] | number | null) to update the individual.

Archived custom properties are not accepted.

Responses

400

The request is either malformed or contain invalid parameters.

Make sure the identifier specified in the URL is a valid UUID
Make sure the body payload matches the expected schema

404

No individual can be found.

200Returns information of the updated individual ℹ️ Click to see full payload