Get Tags Requiring Action Report
get_tags_requiring_action_reportRetrieve people with expired or warning-period tags for a specified group. Use filters like tag IDs, employee number, or job title to narrow results.
Instructions
Retrieves a list of People who have Tags that are either expired or within their expiration warning period. This report is executed under the context of the specified Group ID. If you want to fetch data for all groups in a company, use all in place of {group_id}. Use this to fetch the full details of a specific Resource Planning records by its identifier. Returns a JSON object describing the requested Resource Planning records. Required parameters: company_id, group_id. Procore API: Resource Management > Resource Planning. Endpoint: GET /rest/v1.0/workforce-planning/v2/companies/{company_id}/groups/{group_id}/reports/tag-action
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | URL path parameter — unique identifier for the company. This parameter accepts both formats: - **Recommended**: Procore company ID (integer) - Use this for new integrations - Legacy: LaborChart UUID format (uuid string... | |
| group_id | Yes | URL path parameter — unique identifier for the group | |
| tagIds | No | Query string parameter — array of UUIDs representing the Tags you want to filter the report by. If not provided, the report includes all Tags available to the Group. | |
| warningTags | No | Query string parameter — determines whether Tags within their expiration warning period should be included in the report. If set to `false`, only expired Tags will be included. | |
| employee_number | No | Query string parameter — filter results by the exact employee number of the Person. | |
| jobTitle | No | Query string parameter — whether to include the person's Job Title. | |
| page | No | Page number for paginated results (default: 1) | |
| per_page | No | Number of items per page (default: 100, max: 100) |