Build with Upivia

# Dispatch a request: send an email through the platform.
# Upivia handles policy + budget checks, debits your wallet,
# calls the underlying provider, and returns a structured result.
curl -X POST https://www.upivia.com/v1/service-requests \
  -H "Authorization: Bearer aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "email.send",
    "payload": {
      "to": "ada@example.com",
      "subject": "Hello from my agent",
      "body": "First message routed through Upivia."
    }
  }'

{
  "status": "executed",
  "request_id": "req_01HQ...",
  "cost_cents": 1,
  "balance_cents": 4999,
  "result": { "provider_message_id": "..." }
}

# Pass the agent key as a Bearer token on every request.
Authorization: Bearer aw_live_xxxxxxxxxxxxxxxxxxxxxxxxx

# Create an agent. The response includes the API key exactly once -
# store it somewhere safe (env var, secret manager) before closing the tab.
curl -X POST https://www.upivia.com/v1/agents \
  -H "Content-Type: application/json" \
  --cookie "authjs.session-token=..." \
  -d '{
    "name": "support-bot",
    "description": "Handles inbound customer email."
  }'

{
  "agent": {
    "id": "agt_01HQ...",
    "name": "support-bot",
    "status": "active",
    "created_at": "2026-05-20T..."
  },
  "api_key": "aw_live_xxxxxxxxxxxxx"
}

# Bind a service to an agent with a monthly cap, daily limit,
# optional approval threshold, and per-service configuration.
curl -X POST https://www.upivia.com/v1/agents/agt_01HQ.../services \
  -H "Content-Type: application/json" \
  --cookie "authjs.session-token=..." \
  -d '{
    "service_id": "svc_email",
    "monthly_budget_cents": 5000,
    "daily_request_limit": 100,
    "approval_threshold_cents": 500,
    "configuration": {
      "allowed_domains": ["example.com"]
    }
  }'

# Disable a service binding. Idempotent - safe to call repeatedly.
curl -X DELETE "https://www.upivia.com/v1/agents/agt_01HQ.../services?service_id=svc_email"

// Dispatch a text-generation request. The Idempotency-Key dedupes
// retries so a flaky network never double-charges your wallet.
const res = await fetch("https://www.upivia.com/v1/service-requests", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.AGENTWALLET_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    operation: "text_generation.generate",
    payload: {
      model: "openai/gpt-4o-mini",
      messages: [{ role: "user", content: "Summarize this PR." }],
    },
  }),
});
const data = await res.json();
if (data.status !== "executed") throw new Error(data.reason_code);
console.log(data.result);

# Same call from Python. Use uuid4() for the idempotency key on each
# logical action; reuse the same key across retries of that action.
import os, uuid, requests

r = requests.post(
    "https://www.upivia.com/v1/service-requests",
    headers={
        "Authorization": f"Bearer {os.environ['AGENTWALLET_KEY']}",
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "operation": "web_search.search",
        "payload": {"query": "GPT-5 release date"},
    },
    timeout=30,
)
data = r.json()
assert data["status"] == "executed", data["reason_code"]
print(data["result"])

{
  "status": "approval_required",
  "request_id": "req_01HQ...",
  "estimated_cost_cents": 800,
  "approval_id": "apr_01HQ..."
}

# Approve resumes the original pipeline. Reject marks it blocked.
curl -X POST https://www.upivia.com/v1/approvals/apr_01HQ.../approve
curl -X POST https://www.upivia.com/v1/approvals/apr_01HQ.../reject