Portravo Construction Takeoff

Attach a PDF the user selected in this conversation as the first plan for a new Portravo project. Plan PDFs must be 10 MiB or smaller. Accepts exactly one of plan, a host-provided download_url and file_id, or plan_inline, canonical base64 of the exact user-uploaded PDF bytes with file_name and application/pdf mime_type, up to 32 KiB. A PDF with no file link above 32 KiB, or any PDF above the direct limit, is uploaded in the browser at the project's reviewUrl instead. That browser path streams up to 50 MiB for the selected automatic trades. Projects that already have a plan or review work are refused, so existing work is never replaced. Repeating a call with the same idempotency_key returns the original result. Stores the selected PDF privately in the connected account; does not extract or consume credits.

Create a new construction estimate project in the connected Portravo account from a project name, an explicit trades selection returned by preflight_takeoff, an optional address and an optional supported metro_code. Trades are required. Repeating a call with the same idempotency_key returns the original project instead of creating another. Returns reviewUrl, the project page where the user can also upload a plan PDF in the browser. Does not run extraction or consume estimate credits.

Get a short-lived Excel XLSX download for an owned Portravo estimate after every takeoff line has been reviewed and the estimate is priced or final. If review is incomplete, the call returns a review_required error with the Portravo review link, where quantities, assembly mappings and pricing are completed. Never exports unreviewed estimates.

Use first after connecting to confirm which Portravo account you are acting on: returns the account id, name and email. Read-only; the remaining takeoff credits are in preflight_takeoff.

Read an owned construction project's plan files (attached from chat or uploaded in Portravo) and extracted takeoff quantities, trades, confidence and human review status. reviewRequired reports whether any line still needs estimator review. Quantities require estimator review before pricing or bidding.

Read an owned project and its latest asynchronous takeoff progress, completion limitations and review link. Never advances or restarts a run, uses credits or changes billing. Poll this tool after run_takeoff returns a running result.

List the regional construction pricing markets supported by Portravo. The returned markets are the accepted metro_code values for create_project. Works before account linking (the standard markets by code, name and state, marked accountLinked false; a linked account also sees local markets and cost indexes).

Find construction projects in the connected Portravo account, including draft, review, priced and final estimates. Returns 50 projects per page; nextOffset is the offset of the next page, or null on the last page.

Before creating or starting a takeoff, inspect current automatic/team-assisted trades, the exact existing-credit requirement, balance, upload limits, published prices and review link. Supply either project_id or proposed trades, or neither to discover availability. Works before account linking without project_id: trades, credit rule and prices only, with existingCreditsAvailable null and accountLinked false. Published prices: $75 per trade on one project, $149 for the whole job, or plan takeoffs (one per trade, three for the whole job). Does not reserve credits, start work, buy anything or bill overage.

Starts a paid takeoff on a project whose plan PDF was attached with attach_plan_pdf or uploaded by the user on the project page in Portravo. Each trade uses one takeoff credit (bought at $75); the whole job uses three ($149 pay as you go). Uses only existing plan allowance and purchased credits, never billed overage. Prerequisites: preflight_takeoff, the user's approval of its trades and creditsRequired, and an attached plan; set confirmed_trades to the approved selection and max_credits to the approved ceiling (defaults to one for older clients). A changed selection/cost or insufficient balance is refused before starting. Repeating a call with the same idempotency_key does not charge again. Returns asynchronous progress; use get_takeoff_status until done, then get_takeoff for source-linked human review. A completed run is not a bid-ready estimate. Failed provider runs refund the reservation; existing review work cannot be overwritten.