Bring ForemanAI’s sheet-aware reasoning into your internal dashboards, ERPs, or ConTech products. Every response cites the source sheet, callout, and condition summary so your teams can trust the output.
Base URL
https://api.foremanai.co
Auth
Bearer token
Formats
JSON in / JSON out
Quickstart
Four steps to wire in ForemanAI.
Create an API key
Contact the ForemanAI team for a scoped token tied to your workspace.
Upload or reference a plan
Use the web app upload or the plan-files endpoint to register sheets.
Submit an analysis job
POST to /api/v1/plan-analyses with the modes (conflicts, rfis, schedule, metadata).
Consume the results
Poll the /api/v1/plan-analyses/<id> resource or subscribe to webhooks for completion events.
Authentication
Bearer tokens with workspace scopes.
Include the header Authorization: Bearer <token> in every request. Tokens map to a workspace and can be limited to read-only, plan submission, or admin scopes.
Environment separation · Sandbox and production tokens are issued separately.
IP and org controls · Optional allowlists keep access limited to your network.
Rotation cadence · Rotate every 60 days or on-demand via the admin console.
Request patterns
Choose the workflow that fits your crews.
Plan analyses
Kick off full sheet reviews
Use when you want conflicts, RFIs, schedule checks, and metadata in a single pass.
plan_id from the uploaded set
modes array: conflicts, rfis, schedule, metadata
Optional notes to direct ForemanAI toward areas of concern
Inline questions
Ask about a specific sheet
Route quick Q&A to the /api/v1/plan-questions endpoint when you only need a citation-backed answer.
Send question, sheet_hint, and optional discipline
Responses cite the sheet, viewport, and callout used
Great for embedding in field or PM dashboards
Bulk sync
Mirror the vault in your system
Use plan-files plus pagination on conflicts to hydrate your BI tools or compliance archives.
All endpoints return deterministic IDs for delta syncing
Webhooks notify you when new conflicts exceed thresholds
Upgrade to keep uploading fresh plan sets. Unlimited reasoning still works on everything already in your vault.
Unlimited reasoning on all saved plans
Deep cross-sheet conflict scans
Full toolbox access + saved sessions
Faster processing & monthly quota refresh
💼 StarterMost Popular
$399/mo
🎯 2-day free trial — no charge today
Unlimited plan uploads · 25 AI prompts / month · 1 seat
Takeoff Studio + verified markups
Estimator + budget & cost generator
Document generator (RFIs, scopes, PDFs)
Computer Control + Email Intelligence
Project Brain + Plan Vault
Job Board & Subs marketplace
Share plan links with collaborators
🏗️ ProGrowing Teams
$799/mo
Unlimited plan uploads · 75 AI prompts / month · 1 seat
Everything in Starter — full platform
Priority processing queue
Faster reasoning priority on chat
Early access to new operators & tools
Bonus capacity for concurrent projects
🚀 EliteWhite Glove
$1,499/mo
Unlimited plan uploads · Unlimited AI prompts · Multi-seat team
Everything in Pro — full platform
Dedicated Foreman concierge
Team collaboration (shared workspace)
Priority support response time
Custom integrations & SLAs available
Need more prompts now?
Buy 10 more prompts for $49 — charges your card on file.
💼
Before you go
Let us make it work. Stay for 30% off your plan — next 3 months.
30% OFF — Next 3 Months
Discount applies to your next 3 billing cycles automatically. Your regular rate resumes after that. You can still cancel any time — one click, no phone calls.
✅
You're locked in.
30% off has been applied to your account for the next 3 billing cycles. We're glad you're staying.