# Intents (/docs/swivy/api-reference/intents)

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

3 operations from the November 1, 2026 deployed contract. [Full OpenAPI schema](/swivy/openapi.json) · [Live interactive reference](https://swivy.swopme.co/docs#reference).

## Create a signing intent [#create-a-signing-intent]

<EndpointHeader method="POST" path="/v1/runtime/intents/signing" base={false} />

**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](/swivy/openapi.json).

**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 [#create-a-transaction-intent]

<EndpointHeader method="POST" path="/v1/runtime/intents/transactions" base={false} />

**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](/swivy/openapi.json).

**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 [#fetch-an-intent-by-id]

<EndpointHeader method="GET" path="/v1/runtime/intents/{intentId}" base={false} />

**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
