Build
API
One presence, one base URL. Everything the app and CLI do, your code can do.
- Base URL
- api.yuzu.computer
- Version
- /v1
- Auth
- Bearer ysk_
- Format
- JSON
Base & format
All endpoints are under https://api.yuzu.computer/v1. Requests and responses are JSON; streaming endpoints use SSE. Times are RFC 3339 UTC; on-chain amounts are strings with a unit ("0.05 ETH") to avoid float error.
There is one presence
The single most important thing about this API: there is no POST /presence. Your key resolves to the one presence on your account. Every call acts on it. Nothing here spins up a second — that is the same guarantee the CLI and app run on.
GET /v1/presence/me { "name": "Yuzu", "route": { "model": "claude-sonnet-4-6" }, "memory": { "pinned": 41, "fading": 7 }, "wallet": { "chain": "base", "spend": "policied" } }
Conventions
| Topic | Rule | Notes |
|---|---|---|
| auth | Bearer | Authorization: Bearer ysk_… — see Authentication. |
| idempotency | header | Send Idempotency-Key on writes; a retry returns the original result, not a duplicate action. |
| errors | problem+json | Typed bodies, conventional status — see Events & errors. |
| async | events | Acting takes time and may pause for confirmation; the events stream is how you hear results. |
You never resend conversation history. The thread is server-side — a message is one message, not a transcript.