# Swivy API reference (/docs/swivy/api-reference)

<Callout type="warn" title="Testnet preview">
Staging uses software custody. Use your environment’s API base URL and test assets only.
</Callout>

This reference covers **110 operations across 99 paths**, refreshed from the deployed contract on November 1, 2026. [Download the schema](/swivy/openapi.json) or open the [live interactive reference](https://swivy.swopme.co/docs#reference).

Browsers use an App ID and publishable key; backends use the secret key. Runtime sessions, console operator sessions and organization admin credentials have different scopes. Never expose secret or admin credentials in a browser.

| Section | Operations |
|---|---|
| [Auth & step-up](/docs/swivy/api-reference/auth) | 11 |
| [Accounts & wallets](/docs/swivy/api-reference/accounts) | 9 |
| [Intents](/docs/swivy/api-reference/intents) | 3 |
| [Session grants](/docs/swivy/api-reference/session-grants) | 5 |
| [OIDC & MCP](/docs/swivy/api-reference/oidc) | 13 |
| [Server wallets, users & webhooks](/docs/swivy/api-reference/server) | 15 |
| [Control plane](/docs/swivy/api-reference/control-plane) | 33 |
| [Gas sponsorship](/docs/swivy/api-reference/sponsorship) | 1 |
| [System & capabilities](/docs/swivy/api-reference/system) | 20 |

Errors return an error code and may include reasons or supported actions. Check the operation’s schema and current environment policy; SDK types do not replace server enforcement.
