docs
Get startedTroubleshootingPaymentsWebhooksAgent paymentsSwop MCPOviIdentity (swop.id)SwivyRPC (preview)API reference
API reference

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

POST/v1/runtime/intents/signing

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.

FieldTypeRequiredDescription
accountIdstringYes
chainstringYesAllowed: evm, solana
challengeIdstringNo
payloadobjectYes

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

POST/v1/runtime/intents/transactions

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.

FieldTypeRequiredDescription
accountIdstringYes
chainstringYesAllowed: evm, solana
challengeIdstringNo
payloadobjectYes

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

GET/v1/runtime/intents/{intentId}

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)

ParameterLocationRequiredDescription
intentIdpathYesIntent identifier

Responses: 200 Intent payload · 401 Invalid runtime session or environment credentials · 404 Intent not found

On this page