Esc

↑↓ move↵ openIndex · Pagefind
Admin and security / Approval workflows

Approval workflows

Design multi-step approvals for change orders, pay applications, purchasing, AP and more, then approve from My approvals on the web or your phone.

On this page

Approval workflows add the sign-offs your company needs in front of a record’s own decision. A change order over $25,000 can go to the project manager and then the project executive. A payment run can need a controller, plus the CFO when it is over $100,000. The record’s built-in controls still apply on top of anything you design.

What workflows cover

Record type Where the decision happens
Change orders (prime or commitment PCOs) Approving or executing the change order
Commitment change orders Moving it to approved
Payment applications Certifying (approving) the pay app
Purchase requests Approving the request
Subcontracts and purchase orders Moving the commitment to approved or executed
AP bills Before Accounting’s own approval route
AP payment runs Before release
AR invoices Before approval
Submittals Before an approving final response
Expense reports Approving the report
Budget changes (transfers) Approving the change
Contingency and allowance draws (GMP) Approving the draw

Controls you can’t turn off

A workflow adds approvals. It never removes a control the record type already has. The designer shows these as a locked card at the end of every flow:

  • The person who prepared or submitted a record can never approve it.
  • Each person decides once per approval, including when acting as a delegate.
  • AI agents, automations and service accounts can submit a record for approval, but only a person can approve or reject.
  • Each record type keeps its own rules. For example, AP bills still go through Accounting’s approval route with maker-checker and segregation-of-duties checks, and GMP cost-of-work applications keep their two-person certification.

Create a policy

Company admins manage policies in Company Admin > Workflows > Approval workflows.

  1. Click New policy, or pick a starter under Templates and click Use template. Templates are saved as inactive drafts, so nothing changes until you turn one on.
  2. Name the policy and choose the Record type. Leave Scope on Company-wide, or pick a project to override the company policy on that project only.
  3. Under Applies when, add conditions such as Amount > 25000, % of contract > 10, Vendor risk is one of new_vendor, bank_changed, a cost type or a project. With no conditions the policy applies to every record of that type.
  4. Build the stages. Each card is one stage: give it a name, add approvers and choose a quorum (Any one, All, or N of M). Click + Add stage after for the next step in order, or + Parallel stage to run a stage at the same time as the one beside it.
  5. Open Conditions & SLA on a card to make that stage conditional (for example, only over $100,000), set Due in (hours), a reminder cadence, and when to escalate and to whom.
  6. Set Re-approval: how much an approved amount can grow (by percent or dollars) before it needs approving again.
  7. Click Create policy, then Activate it from the policy list when you’re ready.

When several active policies match a record, a project override wins over company policies, then the lowest Priority number.

Approvers

Approver Who it resolves to
Dynamic: Project manager / Project executive People with that role on the record’s project team
Dynamic: Cost code owner The owners you assign to the cost codes the record touches (set them under Cost code owners on the same page)
Project role Anyone on the project team with that exact role, such as Superintendent
Permission template Project members assigned that template
Accounting role People with that accounting grant role, such as controller or owner
Person One named person
Company admins Every company admin

People the controls rule out (the submitter, someone without access to the tool, an accounting approver without the approve grant) are left out automatically. If nobody is left for a stage, it falls back to company admins.

Simulate before you activate

The Simulate panel under the designer answers “who would approve this record?” using the unsaved draft. Enter a real record id, or an amount, project and submitter. Each stage lists who would be asked and who was left out and why.

Submit a record for approval

When a policy applies, the record’s page shows an Approval workflow panel with its status. Click Submit for approval, optionally with a note for the approvers. Until every stage approves, the record’s own approve, certify or release action is blocked with a message saying why.

Three record types are listed in a register instead of having a page of their own, so their panel sits under the record’s row:

  • Commitment change orders: the commitment’s Change Orders tab. While a workflow is required or running, the change order’s Approve button is hidden.
  • Budget changes: the budget’s Budget Changes tab.
  • Contingency and allowance draws: the Contingency and allowance usage log on the contract’s GMP billing page.

An AR invoice has its own Submit for approval button, which sends it to Accounting’s approval. The workflow panel is separate and sits above it. The invoice can’t be approved until its workflow is approved.

If the amount changes by more than the policy allows after approval, the panel shows Re-approval required and the record needs approving again. If the amount changes while an approval is still running, the next decision starts a fresh round automatically.

My approvals

My approvals (in the app launcher) lists everything waiting on you, including approvals escalated to you and approvals delegated to you. It works on a phone. Tabs show what you decided and what you submitted.

  • Open an approval to see each stage, who has approved, due times, and the full history of who did what and when.
  • Approve, or Reject and return with a reason. A rejection goes back to the submitter with your comment.
  • Select several and click Approve selected to approve in bulk. Payment runs, pay applications, commitments and contingency draws always need opening one at a time.
  • The submitter or a company admin can Withdraw a pending approval.

You get an in-app notification and an email (following your notification preferences) when an approval is waiting on you, reminders while it waits, and the outcome of anything you submitted.

Out of office

Under Out of office on My approvals, choose a colleague and the dates. While the delegation is active they can decide approvals waiting on you. The usual controls still apply to them, and you can revoke it at any time.

Keep exploring

Related across os.construction

Run it on your own project.

Start a 14-day free trial. Want a say in what ships next? Join the founding program.

Your role (optional)

14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →

Ask the OS

Reading this page

Ask anything about this page. Answers use what you're reading as context.

Suggested

    AI · may be imperfect · sample data where shown

    Open file