Base URL
All API endpoints are relative to your Tavryn deployment URL. Replace<your-deployment-url> in every example with the origin of your Tavryn instance (for example, https://tavryn.app if you are using the hosted service).
If you are using the Tavryn hosted service, your base URL is
https://tavryn.app. Self-hosted deployments use the domain you configured during setup.Response Envelope
Every Tavryn endpoint wraps its payload in a standard envelope so you can checksuccess before processing data.
Successful response
details field appears on validation errors and carries structured diagnostic information — for example, the list of specific fields that failed schema validation. For non-validation errors details is omitted.
HTTP Status Codes
Rate Limiting
Tavryn uses a sliding-window rate limiter on agent and cron routes to protect the autonomous pipeline from runaway callers. When you exceed the limit, the API returns HTTP429 with a resetMs field indicating exactly how many milliseconds remain before your window resets.
HTTP 429 response body
Available Endpoints
Contracts
Agent
Approvals
Transactions & Receipts
Business & Settings
Wallet
Import
Webhooks
Cron (Server-to-Server)
Demo
All endpoints (except
/api/demo/session and /api/demo/reset-and-run) require an authenticated session or the appropriate secret header. See the Authentication page for details.Explore the Reference
Authentication
Learn how session cookies, the
businessId tenant scope, and the CRON_SECRET header work together to authenticate every API call.Contracts
Create and manage the SaaS and cloud contracts that Tavryn monitors for upcoming renewal waste.
Agent
Trigger autonomous negotiation, waste analysis, and the full procurement loop on demand.
Approvals
Preview and consume cryptographically signed 1-tap approval links for spending decisions.
Wallet & Receipts
Query your USDC balance on the Arc network and retrieve verified savings receipts.
Business Settings
Fetch and update your organization’s spending policies and category budgets.