Create Company Naming Standard Rule
create_company_naming_standard_ruleCreates a company naming standard rule by providing company ID, trigger field, and definition. Returns the new rule with its ID.
Instructions
Creates a NAMING rule for the company. Only one active naming rule per company is allowed. company_id defaults to the value set by procore_set_config when omitted. Creates the company naming standard rule and returns it with its new id (HTTP 201); calling it again creates another record. 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: company_id, trigger_field, definition. Procore API (v2.0): Core > Assets. Endpoint: POST /rest/v2.0/companies/{company_id}/assets/settings/naming_standard
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rule_name | No | JSON request body field — display name for the rule. Optional: when omitted or blank, the backend auto-generates a scope-indicative name of the form '{rule_type}::{company_id}::{asset_type_id|NA}::{fieldset_id|NA}::{trigger... | |
| rule_type | No | JSON request body field — rule type. Defaults to NAMING for backward compatibility. | |
| company_id | Yes | URL path parameter — unique identifier for the company. | |
| definition | Yes | JSON request body field — structured rule definition. Shape depends on ruleType: FieldRuleDefinitionDTO for NAMING, FieldDefaultsDefinitionDTO for FIELD_DEFAULTS. | |
| description | No | JSON request body field — optional description | |
| fieldset_id | No | JSON request body field — fieldset id (required for FIELD_DEFAULTS). '-1' for Procore default fields; external configurable fieldset id for custom fields. Null for NAMING. | |
| asset_type_id | No | JSON request body field — asset type id (required for FIELD_DEFAULTS; null for NAMING). | |
| trigger_field | Yes | JSON request body field — trigger field. For NAMING: asset_code. For FIELD_DEFAULTS: the field this rule configures (e.g., custom_field_1234, trade_id). | |
| Accept-Language | No | JSON request body field — locale for localized response messages (for example: en, fr-FR, pseudo) |