Update Company Tag
update_company_tagUpdates a company's Resource Planning Tag with new name, global accessibility, and group assignments.
Instructions
Updates a Resource Planning Tag for the given company. Use this to perform the update company action on Resource Planning records. Creates a new Resource Planning records and returns the created object on success (HTTP 201). Required parameters: company_id, tag_id, company_id, name, globally_accessible, group_ids. Procore API: Resource Management > Resource Planning. Endpoint: POST /rest/v1.0/workforce-planning/v2/companies/{company_id}/tags/{tag_id}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | JSON request body field — unique identifier for the company. NOTE - this is a Laborchart company ID. | |
| tag_id | Yes | URL path parameter — unique identifier for the tag. | |
| name | Yes | JSON request body field — the Tag's name. | |
| abbreviation | No | JSON request body field — a 5-character max String representing the abbreviation that will appear in most Tag views. Defaults to the first 5 characters of the name if not provided. | |
| categories | No | JSON request body field — array of Tag Categories this Tag should be available to, if Tag Categories are enabled. | |
| color | No | JSON request body field — hexadecimal color code for the Tag, used for categorization and visual distinction. | |
| expr_days_warning | No | JSON request body field — number of days before expiration when the Tag should be in "warning" mode. Only relevant if `require_expr_date` is true. | |
| globally_accessible | Yes | JSON request body field — controls whether the Tag should be globally available to all current and future Groups. | |
| group_ids | Yes | JSON request body field — array of UUIDs for which Groups this Tag should be available to or be removed from depending on context. For adding availability, if `globally_accessible` is true, this can be an empty array. | |
| require_expr_date | No | JSON request body field — controls whether the Tag should require an expiration date when applied to a Person. |