> ## Documentation Index > Fetch the complete documentation index at: https://docs.rhinestone.dev/llms.txt > Use this file to discover all available pages before exploring further. # Create Intent > Submits a quoted intent for execution. Takes the `intentId` from `POST /quotes` (`routes[].intentId`) plus signatures (origin, destination, optionally target-execution) and optional EIP-7702 authorizations. ## OpenAPI ````yaml https://raw.githubusercontent.com/rhinestonewtf/openapi/refs/heads/main/orchestrator.json post /intents openapi: 3.0.2 info: title: Rhinestone Orchestrator API version: 1.0.0 servers: - url: https://v1.orchestrator.rhinestone.dev security: [] paths: /intents: post: tags: - Intents summary: Create Intent description: >- Submits a quoted intent for execution. Takes the `intentId` from `POST /quotes` (`routes[].intentId`) plus signatures (origin, destination, optionally target-execution) and optional EIP-7702 authorizations. parameters: - name: x-api-key in: header required: true schema: type: string description: Rhinestone API key - name: x-api-version in: header schema: type: string pattern: ^\d{4}-\d{2}\.[a-z0-9]+$ description: >- API version (YYYY-MM.name). Will become required in a future release. example: 2026-01.alps requestBody: description: Body content: application/json: schema: type: object properties: intentId: type: string pattern: ^\d+$ description: >- Identifier of the intent returned by `POST /quotes` (as `routes[].intentId`). signatures: type: object properties: origin: type: array items: oneOf: - type: string pattern: ^0x[a-fA-F0-9]*$ - type: object properties: preClaimSig: type: string pattern: ^0x[a-fA-F0-9]*$ notarizedClaimSig: type: string pattern: ^0x[a-fA-F0-9]*$ required: - preClaimSig - notarizedClaimSig description: Origin (source chain) signatures example: - 0x... - 0x... destination: type: string pattern: ^0x[a-fA-F0-9]*$ description: Destination (target chain) signature example: 0x... targetExecution: type: string pattern: ^0x[a-fA-F0-9]*$ description: >- Target execution signature (smart sessions only; omit for EOA) example: 0x... required: - origin - destination authorizations: type: object properties: sponsor: type: array items: type: object properties: chainId: type: string pattern: ^eip155:\d+$ description: >- Chain ID for EIP-7702 delegation, 0 means it can be applied to any chain example: eip155:42161 address: type: string description: Address of the delegate for EIP-7702 delegation example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' nonce: type: number description: Nonce for EIP-7702 delegation example: '0' yParity: type: number description: Y parity for EIP-7702 delegation example: 27 r: type: string pattern: ^0x[a-fA-F0-9]*$ description: R value for EIP-7702 delegation example: 0x... s: type: string pattern: ^0x[a-fA-F0-9]*$ description: S value for EIP-7702 delegation example: 0x... required: - chainId - address - nonce - yParity - r - s description: EIP-7702 authorizations signed by the sponsor account recipient: type: array items: type: object properties: chainId: type: string pattern: ^eip155:\d+$ description: >- Chain ID for EIP-7702 delegation, 0 means it can be applied to any chain example: eip155:42161 address: type: string description: Address of the delegate for EIP-7702 delegation example: '0x579d5631f76126991c00fb8fe5467fa9d49e5f6a' nonce: type: number description: Nonce for EIP-7702 delegation example: '0' yParity: type: number description: Y parity for EIP-7702 delegation example: 27 r: type: string pattern: ^0x[a-fA-F0-9]*$ description: R value for EIP-7702 delegation example: 0x... s: type: string pattern: ^0x[a-fA-F0-9]*$ description: S value for EIP-7702 delegation example: 0x... required: - chainId - address - nonce - yParity - r - s description: EIP-7702 authorizations signed by the recipient account required: - intentId - signatures responses: '201': description: '201' content: application/json: schema: type: object properties: intentId: type: string pattern: ^\d+$ required: - intentId description: Intent operations submitted successfully '400': description: '400' content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: nullable: true description: >- Structured issue context (e.g. `{ path: "body.accountAddress" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: nullable: true required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: oneOf: - type: boolean - type: string enum: - read - write description: Minimum level the endpoint demands actual: oneOf: - type: boolean - type: string enum: - none - read - write description: Level resolved on the key required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - CONFLICT - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - INTERNAL_ERROR message: type: string description: Human-readable error message example: Invalid input required: - code - message description: Invalid request parameters '403': description: '403' content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: nullable: true description: >- Structured issue context (e.g. `{ path: "body.accountAddress" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: nullable: true required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: oneOf: - type: boolean - type: string enum: - read - write description: Minimum level the endpoint demands actual: oneOf: - type: boolean - type: string enum: - none - read - write description: Level resolved on the key required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - CONFLICT - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - INTERNAL_ERROR message: type: string description: Human-readable error message example: Invalid input required: - code - message description: API key scope denied '404': description: '404' content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: nullable: true description: >- Structured issue context (e.g. `{ path: "body.accountAddress" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: nullable: true required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: oneOf: - type: boolean - type: string enum: - read - write description: Minimum level the endpoint demands actual: oneOf: - type: boolean - type: string enum: - none - read - write description: Level resolved on the key required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - CONFLICT - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - INTERNAL_ERROR message: type: string description: Human-readable error message example: Invalid input required: - code - message description: >- The quoted intent has expired or was already submitted. Request a new route to retry. '500': description: '500' content: application/json: schema: discriminator: propertyName: code oneOf: - type: object properties: code: type: string enum: - VALIDATION_ERROR message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string description: Human-readable issue description context: type: object additionalProperties: nullable: true description: >- Structured issue context (e.g. `{ path: "body.accountAddress" }`) required: - message description: Per-field validation issues required: - code - message - type: object properties: code: type: string enum: - SIMULATION_FAILED message: type: string description: Human-readable error message example: Invalid input details: type: object properties: nonce: type: string category: type: string errorSelector: type: string errorName: type: string errorArgs: type: object additionalProperties: type: string retryable: type: boolean retryHint: type: string enum: - RE_PREPARE - RETRY_LATER simulations: nullable: true required: - category - errorSelector - errorName - retryable additionalProperties: true description: Classified on-chain simulation failure details required: - code - message - type: object properties: code: type: string enum: - INSUFFICIENT_LIQUIDITY message: type: string description: Human-readable error message example: Invalid input details: type: object properties: availableIntents: type: array items: type: object additionalProperties: type: string description: Intents fillable with current liquidity unfillable: type: object additionalProperties: type: string description: Token amounts that cannot be filled required: - availableIntents - unfillable description: Fillable subset and unfillable remainder required: - code - message - type: object properties: code: type: string enum: - KEY_SCOPE_DENIED message: type: string description: Human-readable error message example: Invalid input details: type: array items: type: object properties: message: type: string context: type: object properties: scope: type: string enum: - allowMainnet - intents - deposits description: Which scope rejected the request required: oneOf: - type: boolean - type: string enum: - read - write description: Minimum level the endpoint demands actual: oneOf: - type: boolean - type: string enum: - none - read - write description: Level resolved on the key required: - scope - required - actual required: - message - context description: Single-element list describing the failing scope required: - code - message - type: object properties: code: type: string enum: - NOT_FOUND - UNAUTHORIZED - FORBIDDEN - CONFLICT - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - SETTLEMENT_QUOTE_ERROR - SETTLEMENT_EXECUTION_ERROR - EXTERNAL_SERVICE_TIMEOUT - RELAYER_MARKET_UNAVAILABLE - INTERNAL_ERROR message: type: string description: Human-readable error message example: Invalid input required: - code - message description: Server error ````