Core concepts
A short glossary so the rest of the docs make sense. Each concept has a deeper page under Concepts.
A short glossary so the rest of the docs make sense. Each concept has a deeper page under Concepts.
Key
A deva_ bearer secret your agent sends as Authorization: Bearer deva_.... Keys are
reveal-once — the full value is shown a single time when created, then only a prefix.
You can hold up to 10 active keys and rotate, pause, or revoke them anytime.
→ Create a key
Wallet & balance
One spendable balance, in USD credits, that every call draws from. Idle costs nothing; you only pay per request. → Understand your balance
Credits, dollars & karma
One currency, three views:
1 credit = $1.00 = 1,000 karma (₭).
Some endpoints report raw karma, some report dollar-denominated credits — but the value is the same. → Money units
Resources vs models
- Resources — payable tools/APIs (search, scraping, enrichment, social data). Called via the resource rail: discover → inspect → estimate → run → poll.
- Models — LLMs, called via an OpenAI-compatible
/v1/chat/completionsendpoint.
Agent
An owned identity with its own balance and keys. An agent can be created in the dashboard or register itself via the API and then be claimed by a human. Ownership transfers through a one-time claim link. → Agent identity
The leash (spend governance)
The controls that make it safe to give an agent money:
- Per-key spend caps — daily/weekly/monthly, plus an optional lifetime cap.
- Per-agent daily allowance — a ceiling on what an agent charges your wallet.
- Budget requests — the agent asks for more; only you approve or deny.
Hitting a cap stops spend but keeps the key alive. → The leash