List Project Assignments For A Company User
list_project_assignments_for_a_company_userRetrieve current and potential project assignments for a user, including permission templates and roles. Filter by project stage, type, status, or assignment status for targeted results.
Instructions
This endpoint returns the current and potential Project assignments for the specified User. This includes Project information, as well as the Permission Template and Roles assigned to a given user when they are assigned on a Project. Use this to enumerate Project records when you need a paginated overview, to find IDs, or to filter by query parameters. Returns a paginated JSON array of Project records. Use page and per_page to control pagination; the response includes pagination metadata. Required parameters: company_id, user_id. Procore API: Core > Project. Endpoint: GET /rest/v1.0/companies/{company_id}/users/{user_id}/project_assignments
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | URL path parameter — unique identifier for the company. | |
| user_id | Yes | URL path parameter — unique identifier of the user | |
| page | No | Query string parameter — page number for paginated results (default: 1) | |
| per_page | No | Query string parameter — number of items per page (default: 100, max: 100) | |
| filters__active | No | Query string parameter — if true, returns item(s) with a status of 'active'. | |
| filters__name | No | Query string parameter — filter item(s) with matching name. | |
| filters__by_stage | No | Query string parameter — return item(s) with the specified project stage ID(s). | |
| filters__by_type | No | Query string parameter — return item(s) with the specified project type ID(s). | |
| filters__by_program | No | Query string parameter — return item(s) with the specified project program ID(s). | |
| filters__by_region | No | Query string parameter — return item(s) with the specified project region ID(s). | |
| filters__by_status | No | Query string parameter — return item(s) with the specified status value. Must be one of Active, Inactive, or All. | |
| filters__project_roles | No | Query string parameter — return item(s) with the Project Role ID(s). | |
| filters__project_permission_templates | No | Query string parameter — return item(s) with the Project Permissions Template ID(s). | |
| filters__assignment_status | No | Query string parameter — filters projects to those matching the given assignment status. | |
| sort | No | Query string parameter — sort the results by the specified field. | |
| direction | No | Query string parameter — sort direction. Default is ascending, nulls first. |