Update Project Person
update_project_personUpdate a project user's details with partial field updates. Returns the modified person record, with error payloads for authentication, permission, or not found issues.
Instructions
Update the specified Project User. 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. project_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 project 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: project_id, id, last_name. Procore API: Core > Directory. Endpoint: PATCH /rest/v1.0/projects/{project_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). Users without read permissions to Directory are limited to the normal and extended views. If a v... | |
| job_title | No | JSON request body field — the Job Title of the Project Person | |
| last_name | Yes | JSON request body field — the Last Name of the Project Person | |
| origin_id | No | JSON request body field — the ID of the External Data associated with the Project Person | |
| first_name | No | JSON request body field — the First Name of the Project Person | |
| project_id | Yes | URL path parameter — unique identifier for the Procore project | |
| employee_id | No | JSON request body field — the Employee ID of the Project Person | |
| is_employee | No | JSON request body field — the Employee status of the Project Person | |
| work_classification_id | No | JSON request body field — the unique identifier for the work classification of the Project Person. |