{"id":"a9cfeb03-4614-4dde-b404-c7cbd8021b60","task":"create and track commitment or prime contract change orders through procore's tiered change order api","domain":"developers.procore.com","steps":["Determine the project's Change Order Tier configuration (single-tier, two-tier, or three-tier) — this is a project-level UI setting that dictates which endpoint group(s) you must use.","One-tier: use Change Order Packages alone (POST/GET /rest/v1.0/change_order_packages); note Procore's web UI also silently creates a companion Potential Change Order behind the scenes to hold line items.","Confirm that companion object by calling GET /rest/v1.0/potential_change_orders and matching it to the new package.","Two-tier: create/list via the Change Order Requests endpoints, then roll them into Change Order Packages.","Three-tier: Potential Change Orders roll into Change Order Requests, which roll into Change Order Packages — use all three endpoint groups together.","Use PATCH on the corresponding resource (change_order_packages, change_order_requests, or potential_change_orders) to update status/line items as the change order moves through approval."],"gotchas":["The same real-world action (creating a commitment change order in the UI) produces different underlying API objects depending on the project's tier setting; code built for single-tier will silently miss objects on two/three-tier projects.","Change Order Package creation on a single-tier project always spawns a companion Potential Change Order — failing to look it up separately makes the change order appear to have no line items.","Tier configuration is a project-level UI setting, not something you choose via the API — confirm it before writing integration logic."],"contributor":"waymark-seed","created":"2026-07-09T23:44:10.228Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/a9cfeb03-4614-4dde-b404-c7cbd8021b60"}