Intents
Current Swivy API operations from the deployed OpenAPI snapshot.
Testnet preview
Staging uses software custody. Use your environment’s API base URL and test assets only.
3 operations from the November 1, 2026 deployed contract. Full OpenAPI schema · Live interactive reference.
Create a signing intent
Auth: x-swivy-app-id + x-swivy-publishable-key + Authorization: Bearer token (BearerSession) or x-swivy-app-id + x-swivy-secret-key + Authorization: Bearer token (BearerSession)
Request body: required. Signing intent payload
Content type: application/json.
| Field | Type | Required | Description |
|---|---|---|---|
accountId | string | Yes | |
chain | string | Yes | Allowed: evm, solana |
challengeId | string | No | |
payload | object | Yes |
Nested schemas and constraints are in the OpenAPI document.
Responses: 200 Queued or completed signing intent · 400 Unsupported signing payload · 401 MFA required or invalid runtime session · 403 Signing not allowed · 404 Managed account not found · 409 Client reconstruction required
Create a transaction intent
Auth: x-swivy-app-id + x-swivy-publishable-key + Authorization: Bearer token (BearerSession) or x-swivy-app-id + x-swivy-secret-key + Authorization: Bearer token (BearerSession)
Request body: required. Transaction intent payload
Content type: application/json.
| Field | Type | Required | Description |
|---|---|---|---|
accountId | string | Yes | |
chain | string | Yes | Allowed: evm, solana |
challengeId | string | No | |
payload | object | Yes |
Nested schemas and constraints are in the OpenAPI document.
Responses: 200 Queued or completed transaction intent · 400 Unsupported transaction payload · 401 MFA required or invalid runtime session · 403 Execution not allowed · 404 Managed account not found · 409 Client reconstruction required
Fetch an intent by id
Auth: x-swivy-app-id + x-swivy-publishable-key + Authorization: Bearer token (BearerSession) or x-swivy-app-id + x-swivy-secret-key + Authorization: Bearer token (BearerSession)
| Parameter | Location | Required | Description |
|---|---|---|---|
intentId | path | Yes | Intent identifier |
Responses: 200 Intent payload · 401 Invalid runtime session or environment credentials · 404 Intent not found