Update Company Person
update_company_personUpdate a company person's details in Procore by sending only the fields to change. Returns the modified company person record.
Instructions
Update the specified Company Person. Send only the fields you intend to change; omitted fields keep their current values. Pass the record's fields as top-level arguments — they are nested under "person" in the request payload for you. company_id defaults to the value set by procore_set_config when omitted, and id must identify an existing parent record — resolve it with the matching list tool first. Returns the modified company person on success. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, and 404 when an id does not resolve. Required parameters: company_id, id, last_name. Procore API: Core > Directory. Endpoint: PATCH /rest/v1.0/companies/{company_id}/people/{id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | URL path parameter — unique identifier of the Directory resource | |
| view | No | Query string parameter — specifies which view of the resource to return (which attributes should be present in the response). If a valid view is not provided, it will default to normal. | |
| active | No | JSON request body field — the active status of the Company Person | |
| job_title | No | JSON request body field — the Job Title of the Company Person | |
| last_name | Yes | JSON request body field — the Last Name of the Company Person | |
| origin_id | No | JSON request body field — the Origin ID of the Company User | |
| company_id | Yes | URL path parameter — unique identifier for the Procore company | |
| first_name | No | JSON request body field — the First Name of the Company Person | |
| employee_id | No | JSON request body field — the Employee ID of the Company Person | |
| is_employee | No | JSON request body field — the Employee status of the Company Person | |
| work_classification_id | No | JSON request body field — the unique identifier for the work classification of the Company Person. |