# Agave > Agave is a unified API for the construction industry: one REST contract to read and write data > across 100+ construction and accounting systems — Procore, Autodesk Build, QuickBooks, Sage, > Viewpoint, Acumatica, Foundation, CMiC, ServiceTitan and more. Agave normalises projects, budgets, > contracts, commitments, purchase orders, invoices, payments, cost codes, vendors, timesheets and > files into one model, brokers the source-system OAuth through a hosted Link component, and layers > AP automation, expense management, AI analytics and an MCP server on top. Generated by API Evangelist on 2026-08-30. Agave publishes no llms.txt of its own (https://useagave.com/llms.txt and https://docs.agaveapi.com/llms.txt both return 404, checked 2026-08-30), so this file is generated from the Agave developer documentation and the artifacts in https://github.com/api-evangelist/agave. Everything below was fetched or derived from a published Agave source; nothing is invented. ## What you need to know before calling it - Base URL: https://api.agaveapi.com — there is NO /v1 prefix and NO sandbox host. - `API-Version: 2021-11-21` is required on every request; omitting it returns 401. - Auth is three static headers, not OAuth: `Client-Id` (36-char UUID), `Client-Secret` (40-char string), and `Account-Token` (per linked customer account). Issued by api-support@agaveapi.com. - OAuth exists one layer down: Agave Link performs it against the source system and returns an Account-Token. There are no scopes on Agave's own API. - Pagination: `page` + `per_page` (max 1000); keep paging until `meta.has_more_results` is literally `false` — some source systems return `null`, which does not mean done. - Errors are `{"message": "..."}` or `{"error": "..."}` — not RFC 9457, and there is no error code. - Rate limits: 150 requests/minute per linked account plus the source system's own; read `Agave-RateLimit-Remaining` and `{SourceSystem}-RateLimit-Remaining`. 429 on exhaustion, no Retry-After. - Writes are effectively irreversible through Agave — no undo, void or reversal operation and no stated reversal window. ## APIs - [Agave Unified Construction API](https://docs.agaveapi.com/): one REST API over 100+ construction and accounting systems. Base https://api.agaveapi.com - [Agave Link](https://docs.agaveapi.com/agave-link/quickstart): hosted front-end component that handles source-system authentication and returns an Account-Token. - [Agave MCP](https://useagave.com/agave-mcp): read-only MCP server exposing ERP and PM data to ChatGPT, Claude and Microsoft Copilot. Endpoint is not published; provisioned through sales. ## Specs and machine-readable contracts - [Postman Collection (Agave-published, 437 requests)](https://docs.agaveapi.com/postman/AgaveAPI-2024-09-10.zip) - [Postman collection, saved verbatim](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/collections/agave-api-provider.postman_collection.json) - [OpenAPI derived from that collection — 228 paths, 427 operations](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/openapi/_ae-authored/agave-unified-api-from-postman-openapi.yml) - Agave publishes no OpenAPI, no AsyncAPI and no GraphQL endpoint (probed 2026-08-30). ## Documentation - [Developer Center](https://docs.agaveapi.com/) - [API Reference](https://docs.agaveapi.com/reference) - [Headers — auth, scoping, source data, async](https://docs.agaveapi.com/agave-api/headers) - [API Versioning](https://docs.agaveapi.com/agave-api/api-versioning) - [Pagination](https://docs.agaveapi.com/agave-api/pagination) - [Response Codes](https://docs.agaveapi.com/agave-api/response-codes) - [Rate Limits](https://docs.agaveapi.com/agave-api/rate-limits) - [Webhooks](https://docs.agaveapi.com/agave-api/webhooks) - [Async Requests](https://docs.agaveapi.com/agave-api/async-requests) - [Passthrough Requests](https://docs.agaveapi.com/agave-api/passthrough-requests) - [Sandbox Environments](https://docs.agaveapi.com/agave-api/sandbox-environments) - [Reference ID](https://docs.agaveapi.com/agave-api/reference-id) - [Identifiers](https://docs.agaveapi.com/agave-api/identifiers) - [Source System Guides](https://docs.agaveapi.com/source-systems) ## Company - [Home](https://useagave.com) - [Pricing](https://useagave.com/pricing) — custom quotes only, no published list prices - [Product Updates / changelog](https://useagave.com/product-updates) - [Blog](https://useagave.com/blog) - [Integrations](https://useagave.com/integrations) - [Status](https://status.agaveapi.com) - [Security / trust centre](https://security.agaveapi.com) - [Terms](https://useagave.com/terms) · [Privacy](https://useagave.com/privacy) - [GitHub](https://github.com/agave-api) — 4 repositories, all archived - Support: api-support@agaveapi.com · support@agaveapi.com ## API Evangelist artifacts - [apis.yml](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/apis.yml) - [Authentication](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/authentication/agave-authentication.yml) - [Conventions + reversibility](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/conventions/agave-conventions.yml) - [Rate limits](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/rate-limits/agave-rate-limits.yml) - [Error catalog](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/errors/agave-problem-types.yml) - [Webhooks](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/asyncapi/agave-webhooks.yml) - [Lifecycle](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/lifecycle/agave-lifecycle.yml) - [Sandbox](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/sandbox/agave-sandbox.yml) - [Data model](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/data-model/agave-data-model.yml) - [Agent Skills](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/skills/_index.yml) - [Packages / SDKs](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/packages/agave-packages.yml) - [Conformance](https://raw.githubusercontent.com/api-evangelist/agave/refs/heads/main/conformance/agave-conformance.yml)