For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
API StatusPartner Portal
HomeGuidesAPI ExplorerSDKsGitHubSupport
HomeGuidesAPI ExplorerSDKsGitHubSupport
  • API Concepts
    • Overview
    • Environments and URLs
    • Authentication
    • API versioning
    • Rate limiting
    • HTTP headers
    • Pagination, sorting, and filtering
  • General
  • Common
      • GETGet all persons
      • POSTCreate a person
      • GETGet a person
      • DELDelete a person
      • PATCHUpdate a person
  • Accounts payable
  • Accounts receivable
  • E-invoicing
  • Payments
  • Accounting integration
  • Expense management
  • Utilities
LogoLogo
API StatusPartner Portal
CommonEntity persons

Update a person

PATCH
/persons/:person_id
PATCH
/v1/persons/:person_id
$curl -X PATCH https://api.sandbox.monite.com/v1/persons/person_id \
>     -H "x-monite-version: 2023-09-01" \
>     -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "id": "id",
3  "created_at": "2024-01-15T09:30:00Z",
4  "updated_at": "2024-01-15T09:30:00Z",
5  "email": "email",
6  "entity_id": "entity_id",
7  "first_name": "first_name",
8  "last_name": "last_name",
9  "relationship": {
10    "director": true,
11    "executive": true,
12    "owner": true,
13    "percent_ownership": 1.1,
14    "representative": true,
15    "title": "title"
16  },
17  "address": {
18    "city": "city",
19    "country": "country",
20    "line1": "line1",
21    "postal_code": "postal_code",
22    "line2": "line2",
23    "state": "state"
24  },
25  "date_of_birth": "date_of_birth",
26  "id_number": "id_number",
27  "phone": "phone",
28  "ssn_last_4": "ssn_last_4"
29}
Was this page helpful?
Previous

Get an entity's VAT IDs

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

person_idstringRequired

Headers

x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.
addressobjectOptional
The person's address
date_of_birthstringOptionalformat: "date"
The person's date of birth
emailstringOptionalformat: "email"
The person's email address
first_namestringOptional
The person's first name
id_numberstringOptional
The person's ID number, as appropriate for their country
last_namestringOptional
The person's last name
phonestringOptional
The person's phone number
relationshipobjectOptional
Describes the person's relationship to the entity
ssn_last_4stringOptional
The last four digits of the person's Social Security number

Response

Successful Response
idstringformat: "uuid"
The person's unique identifier
created_atdatetime
Time at which the person was created
updated_atdatetime
Time at which the person was updated
emailstringformat: "email"
The person's email address
entity_idstringformat: "uuid"
Entity ID
first_namestring
The person's first name
last_namestring
The person's last name
relationshipobject
Describes the person's relationship to the entity
addressobject
The person's address
date_of_birthstringformat: "date"
The person's date of birth
id_numberstring
The person's ID number, as appropriate for their country
phonestring
The person's phone number
ssn_last_4string
The last four digits of the person's Social Security number

Errors

404
Patch Persons ID Request Not Found Error
409
Patch Persons ID Request Conflict Error
422
Patch Persons ID Request Unprocessable Entity Error
500
Patch Persons ID Request Internal Server Error