Getting Started

Upivia is a governance layer between AI agents and the outside world. Instead of giving your agent ten different API keys, you give it one Upivia API key — and every action flows through policy, budget, approval, and audit.

What is Upivia?

Introduction

Upivia is a governance layer between AI agents and the outside world. Instead of giving your agent ten different API keys, you give it one Upivia API key. Every action — email, search, LLM, code, calendar — flows through a single pipeline that checks policy, enforces budgets, requires approval when needed, and logs everything to an immutable audit trail.

Tutorial1 / 4
1
Agent
→
2
Service Request
→
3
Policy Check
→
4
Budget Check
→
5
Approval Gate
→
6
Provider Execution
→
7
Audit Log

Agent Sends Request

Your AI agent calls POST /api/v1/service-requests with its API key. One endpoint, one key.

The Pipeline

text
AI Agent
  │  Bearer agent_key_live_...
  ▼
POST /api/v1/service-requests
  │
  ├─ 1. Policy Check      — Does the agent have permission?
  ├─ 2. Budget Check       — Monthly cap? Daily limit? Balance?
  ├─ 3. Approval Gate      — Cost > threshold? Queue for review.
  ├─ 4. Provider Execution — Call the real service.
  ├─ 5. Balance Debit      — Deduct cost from org wallet.
  └─ 6. Audit Log          — Record everything (hash chained).
Agents never call external providers directly. No stolen API keys, no runaway spend, no mysteries.

Key Numbers

Service families23 across 40+ operations
API endpoints161
CLI commands17
Local file tools11
OpenRouter models300+
Connected app providers6 (Slack, Nylas, HubSpot, Salesforce, Jira, Linear)
5 minutes to your first agent

Quickstart

1. Sign Up

Create an account at /signup. Every account gets a dedicated workspace with its own balance.

2. Top Up

Go to Money and add funds via Stripe. New accounts start with a free trial balance.

3. Create Agent

Visit /agents, click New agent, name it, copy the API key. Use test-mode keys (agent_key_test_) during development — no real money spent.

4. Enable Services

In the agent's Services tab, toggle on what you need. Set monthly budgets and daily limits.

5. Dispatch

bash
curl -X POST https://www.upivia.com/api/v1/service-requests \
  -H "Authorization: Bearer agent_key_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"operation":"web_search.search","payload":{"query":"AI governance"}}'

CLI Quickstart

bash
uv tool install upivia-tui
upivia-tui init               # authenticate
upivia-tui                    # launch the TUI
upivia-tui --dir ~/project    # launch in a project dir
upivia-tui --background       # headless device for the web app
Tutorial1 / 5
1
Visit /signup
2
Choose email or OAuth
3
Create workspace
4
Get trial balance

Sign Up

Create account at /signup via email or OAuth. Every account gets a dedicated workspace with its own balance.

Next chapterCore Concepts — Organizations, teams, agents, services, budgets, and permissions