Skip to content
Tovari Docs
Search
Ctrl
K
Cancel
Tovari
Select theme
Dark
Light
Auto
Start here
Overview
Where each feature works
Glossary
Quick start
What Tovari does
Create your account
Add your first account
Connect a bank with Plaid
The budget interview
Reading your register
Categorizing spending
Your first envelope
Scheduling a bill
Understanding Safe to Spend
Features
Accounts
AI assistants
Bank connections
Bills
Budget
Categories
Credit card statements
Dashboard
Data and privacy
Email verification
File import
Getting help
Getting set up
Help chat
Home Screen widgets
Household
Investments
Legal policies
Payees
Reports
Review Center
Safe to Spend
Settings
Signing in
Split transactions
Transactions
Two-factor authentication
What's New
What's New
2026.11.10.1
2026.11.08.1
2026.11.06.1
2026.11.05.1
2026.11.04.1
2026.11.03.3
2026.11.03.2
2026.11.03.1
2026.11.02.1
2026.10.26.1
2026.10.20.2
2026.10.20.1
2026.10.17.1
2026.10.15.1
2026.10.12.2
2026.10.12.1
2026.10.09.1
2026.10.08.1
2026.10.07.2
2026.10.07.1
2026.10.06.2
2026.10.06.1
2026.10.05.3
2026.10.05.2
2026.10.05.1
2026.10.03.2
2026.10.03.1
2026.10.02.2
2026.10.02.1
2026.10.01.3
2026.10.01.2
2026.10.01.1
2026.09.29.1
2026.09.28.1
2026.09.24.1
2026.09.22.1
2026.09.21.1
2026.09.20.1
2026.09.18.1
2026.09.16.1
2026.09.15.1
2026.09.12.1
2026.09.07.1
2026.09.06.1
2026.09.04.1
2026.09.03.1
2026.09.02.3
2026.09.02.2
2026.09.02.1
2026.09.01.1
2026.08.31.2
2026.08.31.1
2026.08.30.1
2026.08.29.1
2026.08.28.1
2026.08.23.1
2026.08.20.1
2026.08.18.1
2026.08.15.1
2026.08.11.1
2026.08.09.1
API reference
Overview
Auth
Overview
Sign up a new user + organization
Log in with email + password
Sign in / sign up with a Google credential
Sign in / sign up with a Sign in with Apple credential
Start a password reset (emails a code)
Confirm a password reset with a code
Approve a support-requested MFA reset (single-use emailed token)
Mark the caller's onboarding as completed
Exchange a refresh token for fresh tokens
Accounts
Overview
List accounts
Create an account
Reorder accounts (drag reorder)
Get one account
Update / close / reopen an account
Close (soft-delete) an account
Permanently delete an account
One account's actual and projected daily balance with threshold facts
A credit card's statement details, user-entered terms and credit limit
Market-value history for an investment account
Investment accounts whose tax treatment still needs an answer
Confirm, override or defer one account's tax treatment
Answer up to 50 accounts in one round trip
Record that the account-type prompt was actually rendered
Reconcile an account to a statement balance
Apply a fix to a credit-card statement that needs review
Undo one fix applied to a credit-card statement
Get the register View filter preference
Upsert the register View filter preference
Budget
Overview
Budget view for a month
Create a budget section
Update a budget section
Delete a budget section
Selectable categories for a category picker
Create a budget category
Update a budget category
Delete a budget category
Toggle a category as budgeted for a month
One category's per-month history over a month range
Upsert a monthly budgeted amount
Batch set budgeted envelopes for a month
Transactions
Overview
List transactions for one account or several (keyset paginated)
Create a transaction
Export the filtered register as an .xlsx workbook
Get the saved Transactions-screen view
Save the Transactions-screen view
List the split nudges the caller has answered
Record an answer to a split nudge
Update a transaction
Delete a transaction
Split a transaction across categories (create or replace its lines)
Remove a split, putting the transaction on one category
Dismiss a possible-duplicate pair (a permanent "not the same transaction" verdict)
Restore a dismissed possible-duplicate pair to the queue
Retire one surplus bank copy of a duplicated charge (bank-vs-bank pairs only)
Payees
Overview
List payees
Create a payee
Merge payees into one
Update a payee
Delete (deactivate) a payee
Apply the payee's saved default category to its existing transactions
Bills
Overview
List bill schedules
Create a bill schedule
Plaid-detected recurring charges without a matching bill
Dismiss a suggestion (permanent until restored)
Restore a dismissed suggestion — the only way one returns
Dashboard balance projection + upcoming bills
Outstanding scheduled occurrences for one or more accounts
Org-wide scheduled occurrences for ONE calendar month
Update a bill schedule
Delete a bill schedule
Post a scheduled occurrence into the register
Skip a scheduled occurrence (advance cursor only)
Mark an occurrence as already paid out of band (and link its payment if already posted)
Remove an occurrence's already-paid mark
Preview how ONE hypothetical change to one occurrence moves the projection
One bill's match decision log
Card payment editor figures for one card
Reports
Overview
Spending by category (?month= widget, or ?preset/start/end range)
Spending by payee (?month= widget, or ?preset/start/end range)
Spending by month over a range
Payee flyout for one bar segment of Spending by Month
Drill-down transactions for one payee within a range
Income vs expense over a month range
Per-month drill-down behind one Income vs Expense row
The household's earliest activity month (custom-range month picker floor)
Net worth reconstructed per month over a range
Cash flow: inflow / outflow decomposition + projected balance line
Imports
Overview
Create a presigned S3 upload URL for an import file
List import sessions for an account
Get one import session (grouped staged rows)
Parse/process an uploaded file (may need CSV mapping)
Submit CSV column mapping
Update one staged transaction (confirm/skip/override/payee/category)
Bulk confirm/skip staged transactions
Commit an import session into the register
Cancel an import session
CSV Mapping Profiles
Overview
List saved CSV mapping profiles for an account
Create a CSV mapping profile
Update a CSV mapping profile
Delete a CSV mapping profile
Plaid
Overview
Create a Plaid Link token
Exchange a public token (create or attach accounts)
List linked Plaid items
Disconnect (unlink) a Plaid item
Start re-authentication (create a relink token)
Complete an update-mode Link session (reconcile, or a targeted attach)
Plaid webhook receiver (server-to-server; not browser-called)
Start the statement-sharing consent step (create a consent Link token)
Record the statement-sharing consent after Plaid Link
Lookups
Overview
System reference data grouped by category
Categories
Overview
OTB category catalog + onboarding questionnaire
Adopt OTB categories for the org
Dashboard
Overview
Safe-to-spend disposable-cash figure
Recorded end-of-day Safe to Spend for the last 90 days, by pay period (KAN-4040)
One listed pay period of the Safe to Spend report: its low, what sat around it, and when it recovered (KAN-4040)
Latest non-transfer transactions across all accounts (KAN-485)
Savings goals for the client-local plan year
The caller's own dashboard preferences document
Save the dashboard preference keys this request carries
Notifications
Overview
One page of the caller's own notification feed
The unread badge (no notification rows)
Mark the caller's own notifications read
The caller's delivery preferences, fully resolved
Patch the delivery preferences (atomic)
Register (or refresh) one handset for push
Stop push to one handset
One-click unsubscribe landing (non-mutating redirect)
Turn bulk notification email off (RFC 8058 one-click)
Settings
Overview
The household planning window and cushion, with all three previews
Save the planning window and cushion
The caller's display-language state
Set the caller's display language
Whether the Spanish display language is enabled (signed-out read)
The household's statement-details setting and each card connection's state
Turn credit-card statement details on or off
Policies
Overview
The active policy versions, with their full text
Contact
Overview
Marketing-site contact / early-access capture
Investments
Overview
The investment portfolio for a period: value, net invested, growth and the reconciliation
Current positions, consolidated across accounts and by account
Support
Overview
Ask the docs-grounded in-app help assistant one question
Org
Overview
Start deleting the account (household erasure for an admin; a deletion request for a member)
Reset household data — wipe the household's financial data and start over (admin only)
Invite a partner into the household (admin only)
Billing
Overview
Pay the overdue invoice with the card just saved
Switch between monthly and yearly billing at the end of the period, or keep the current interval
Upgrade the web subscription from Fundamentals to Premier
What the Premier upgrade would charge today and at renewal
Widget
Overview
Mint or renew this device's iOS Home Screen widget key
Revoke one of the caller’s widget keys
The iOS Home Screen widget’s Safe to Spend summary
Register a Home Screen widget push token (iOS WidgetKit or Android FCM)
ConnectedApps
Overview
The pending MCP connection request, for the consent page
Approve an MCP connection request
Deny an MCP connection request
The caller's connected AI apps
Disconnect an AI app
Switch an AI app back to read-only
An AI app's recent changes
Undo one change an AI app made
Tovari
Select theme
Dark
Light
Auto
Overview
ConnectedApps
Section titled “ConnectedApps”
MCP (AI app) connections — the consent page’s request read and decision
Operations
Section titled “Operations”
GET
/connected-apps/requests/{requestId}
POST
/connected-apps/requests/{requestId}/approve
POST
/connected-apps/requests/{requestId}/deny
GET
/connected-apps
DELETE
/connected-apps/{grantId}
PUT
/connected-apps/{grantId}/permission
GET
/connected-apps/{grantId}/changes
POST
/connected-apps/{grantId}/changes/{changeId}/undo