> For the complete documentation index, see [llms.txt](https://docs.blockz.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockz.fi/api/submit-intent.md).

# Submit Intent

An intent represents a user’s signed request to execute a swap under specific conditions.

An intent can only be created from a valid quote and is permanently linked to that quote. It defines the desired outcome of the swap, while execution is handled by the resolver network under the constraints defined in the quote.

Intents are chain-agnostic and support multiple networks and approval mechanisms.

***

#### **Intent lifecycle**

A typical intent progresses through the following stages:

{% stepper %}
{% step %}

#### Creation

The Partner creates an intent via the API using:

* The selected quote identifier
* Source and destination chains
* Token addresses
* Amounts and execution parameters

The intent formally represents the swap conditions agreed upon by the user.
{% endstep %}

{% step %}

#### Approval

The user authorizes fund usage using a network-specific approval mechanism.

Examples include:

* Permit2 or token approvals on EVM networks
* PSBT coordination on Bitcoin
* Cosigned transactions on Solana

Approval enables settlement but does not transfer custody to Blockz.
{% endstep %}

{% step %}

#### Execution

Once the intent is signed and approved, a resolver fulfills it according to the quoted terms.

Execution is coordinated through chain-native escrow and time-bound settlement mechanisms to ensure deterministic outcomes.
{% endstep %}

{% step %}

#### Status Tracking

Intent status can be queried at any time through the Intent API to monitor progress or retrieve the final outcome.
{% endstep %}
{% endstepper %}