Skip to main content
The Business Settings API gives you programmatic control over the rules that govern how Tavryn’s autonomous agent behaves on your behalf. Through this API you can tune the monetary thresholds that determine when the agent acts autonomously versus when it pauses for human approval, configure per-category spending budgets, and connect a webhook URL for real-time notifications. Changes take effect immediately — the agent reads your policy on every decision cycle.

GET /api/business//settings

Retrieve the current configuration for a business, including both the business profile (wallet address, treasury balance, notification settings) and the full policy rule set. Path parameters
string
required
UUID of the business whose settings you want to retrieve.
Response fields
object
object
Valid values for allowed_categories are: software, cloud, contractors, infrastructure, legal, and marketing. Any category not in this list will be rejected by the settings validation layer.
Example request
Example response
Error responses

PUT /api/business//settings

Update your business’s webhook URL and/or procurement policy. You can update either field independently — omit the key you don’t want to change. All updates are written to the database and logged to the immutable audit trail. Path parameters
string
required
UUID of the business to update.
Request body
string | null
New webhook URL for Tavryn notifications. Must be a valid HTTPS URL. Pass null or an empty string "" to remove the current webhook.
object
Example request — update policy thresholds
Example request — update webhook URL only
Example response
Error responses

POST /api/business//settings

Fire a live test notification to a webhook URL. Use this to verify connectivity before saving a new webhook endpoint, or to re-test an existing one after infrastructure changes. Tavryn dispatches a test message to the target URL and reports whether delivery succeeded. Path parameters
string
required
UUID of the business performing the test.
Request body
string
required
The URL to send the test notification to. This does not need to match the currently saved webhook_url — you can test any URL before committing it.
Response fields
boolean
true if the test notification was delivered successfully; false if the target URL was unreachable or returned an error.
string
Human-readable description of the delivery result. Present whether the test succeeded or failed.
string
Summary message confirming the test was dispatched.
Example request
Example response — success
Example response — failure
Always test your webhook before storing it with PUT. The test endpoint sends a clearly labelled 🔔 Tavryn Webhook Integration Test message so your receiving server can identify and handle it separately from live procurement events.
Error responses