Skip to main content
The Contracts API is the entry point for bringing vendor agreements into Tavryn. Once you register a contract, Tavryn continuously monitors it for idle seats, usage decline, and approaching renewal windows — then autonomously opens negotiation rounds to recover spend. Every field you provide sharpens the savings heuristics, so the more detail you include, the better the agent performs.

Create a Contract

If the vendor name you supply does not already exist in Tavryn’s vendor registry, a new vendor record is created automatically with a default reputation score of 4.8 and a derived procurement contact email. No additional setup is required.

Request Body

string
required
UUID of the business that owns this contract. Every contract must be scoped to a business so Tavryn can apply the correct spending policy and treasury balance.
string
required
Display name of the vendor (e.g., "Salesforce", "AWS", "Acme Contractors"). Tavryn performs a case-insensitive lookup; if the name matches an existing vendor record, the contract is linked to it automatically.
string
required
The specific product or service line covered by this contract (e.g., "Sales Cloud Enterprise", "EC2 Reserved Instances"). Used in negotiation outreach and savings reports.
string
default:"software"
Contract category. Must be one of "software", "cloud", or "contractors". Determines which negotiation playbook and heuristic benchmarks apply.
number
required
Annual contract value in USD. Must be a positive number. This is the baseline Tavryn negotiates against — do not include taxes or one-time fees.
string
required
Contract renewal date as an ISO 8601 date string (e.g., "2025-11-01" or "2025-11-01T00:00:00.000Z"). Tavryn uses this date to trigger proactive negotiation before the renewal window closes.
number | null
Total number of licensed seats on the contract. When combined with activeSeats, Tavryn can calculate idle-seat waste and construct a seat-reduction opening offer.
number | null
Number of seats currently in active use. Must not exceed seatCount. The idle seat ratio (seatCount - activeSeats) / seatCount directly feeds the savings estimation model.

Response

A successful request returns the newly created contract record along with the resolved vendor object.
boolean
true when the contract is created without error.
object
The full contract record as persisted in the database.

Example Request

Example Response

Status Codes