List Project Roles
list_project_rolesList all user-role relationships for a specified project to identify available roles and obtain role IDs for use in other Procore API calls. Read-only, paginated JSON response.
Instructions
Return a list of all relationships between Users and Roles in a specified Project. Use this to discover project roles or to look up the id of one before calling a tool that needs it. Returns a JSON array of project roles; page and per_page control pagination and the response reports how many pages remain. Read-only — it changes nothing in Procore. 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. Procore API: Core > Project. Endpoint: GET /rest/v1.0/project_roles
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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) | |
| project_id | Yes | Query string parameter — unique identifier for the project. | |
| filters__created_at | No | Query string parameter — return item(s) created within the specified ISO 8601 datetime range. | |
| filters__add_to_project_team | No | Query string parameter — filter results based on the `add_to_project_team` column. Accepts `true` or `false` to include or exclude items accordingly. |