Skip to main content

​
What is an Agent?

An agent is an AI entity with its own virtual Visa card and spending policy. When you create an agent, Ovra automatically:
  1. Issues a virtual Visa card (via Modulr)
  2. Creates a default spending policy
  3. Assigns the card to your customer’s Modulr account

​
Create an Agent

curl -X POST https://api.getovra.com/agents \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Shopping Agent", "usage": "multi"}'

​
Parameters

FieldTypeDescription
namestringDisplay name for the agent
usage"single" or "multi"Single-use card (one transaction) or multi-use

​
Agent Lifecycle

StatusDescription
activeNormal operation. Card is live.
frozenTemporarily suspended. Card blocked.
closedPermanently closed. Irreversible.

​
Fund an Agent

curl -X POST https://api.getovra.com/agents/ag_xxx/fund \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"amount": 100}'
In sandbox mode, funding is virtual. In live mode, funds come from your SEPA-funded Modulr account.

​
Agent Tokens

For autonomous agent operation, create scoped tokens: 
curl -X POST https://api.getovra.com/agents/ag_xxx/tokens \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"label": "shopping-token", "scopes": ["intents.write", "checkout.write"]}'
Agent tokens start with at_ and can be restricted to specific operations.