> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperrails.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove Quote Item

> Removes a specific allocation or item from an existing quote session using the quote ID and item ID.



## OpenAPI

````yaml PUT /partners/marketplace/quote/{id}/remove/{itemId}
openapi: 3.1.0
info:
  title: HyperRail
  description: HyperRail documentation
  license:
    name: MIT
  version: 1.0.0
servers:
  - description: Live server
    url: https://api.hyperrails.io/api/v1
security:
  - bearerAuth: []
paths:
  /partners/marketplace/quote/{id}/remove/{itemId}:
    put:
      summary: Remove Item from Quote
      description: >-
        Removes a specific allocation or item from an existing quote session
        using the quote ID and item ID.
      parameters:
        - name: id
          in: path
          required: true
          description: The unique identifier (UUID) of the quote session.
          schema:
            type: string
            format: uuid
            example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
        - name: itemId
          in: path
          required: true
          description: The unique identifier of the item/allocation to remove.
          schema:
            type: string
            format: uuid
            example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
      responses:
        '200':
          description: Item removed successfully, returns updated quote state
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuoteResponse'
        '400':
          description: Invalid ID or item not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    QuoteResponse:
      type: object
      properties:
        quoteId:
          type: string
          format: uuid
          description: Unique quote identifier
          example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
        status:
          type: string
          description: Quote status
          enum:
            - pending
            - awaiting_payment
            - completed
            - expired
            - cancelled
          example: pending
        source:
          type: string
          description: Source currency
          example: NGN
        destination:
          type: string
          description: Destination currency
          example: USDT
        chain:
          type: string
          description: Blockchain network
          example: BASE
        amount:
          type: number
          description: Requested amount
          example: 50000
        totalSourceAmount:
          type: number
          description: Total amount in source currency
          example: 50000
        totalDestinationAmount:
          type: number
          description: Total amount in destination currency
          example: 31.65
        clientId:
          type: string
          format: uuid
          description: Client identifier
        mode:
          type: string
          description: Operating mode
          enum:
            - live
            - sandbox
          example: live
        ttl:
          type: integer
          description: Time to live in seconds
          example: 300
        allocationResult:
          $ref: '#/components/schemas/AllocationResult'
        metadata:
          $ref: '#/components/schemas/QuoteMetadata'
        chatMetadata:
          $ref: '#/components/schemas/ChatMetadata'
    Error:
      required:
        - code
        - message
      type: object
      properties:
        code:
          type: string
          description: Error code
          example: INVALID_CURRENCY
        message:
          type: string
          description: Error message
          example: 'Invalid source currency. Supported: NGN, GHS'
        details:
          type: object
          description: Additional error details
          additionalProperties: true
    AllocationResult:
      type: object
      properties:
        totalSourceAmount:
          type: number
          description: Total source amount across all allocations
          example: 50000
        weightedAverageRate:
          type: number
          description: Weighted average exchange rate
          example: 1580.5
        totalDestinationAmount:
          type: number
          description: Total destination amount across all allocations
          example: 31.65
        allocations:
          type: array
          description: Individual provider allocations
          items:
            $ref: '#/components/schemas/Allocation'
    QuoteMetadata:
      type: object
      properties:
        bankPayIn:
          $ref: '#/components/schemas/BankPayInDetails'
        cryptoPayIn:
          $ref: '#/components/schemas/CryptoPayInDetails'
    ChatMetadata:
      type: object
      description: Metadata for chat-based quote negotiation
      properties:
        conversationId:
          type: string
          description: Chat conversation identifier
        chatQuoteId:
          type: string
          description: Chat-specific quote identifier
        listingId:
          type: string
          description: Listing identifier
        initialListingRate:
          type: string
          description: Initial rate from listing
        negotiationStartedAt:
          type: string
          format: date-time
          description: Negotiation start timestamp
        quoteSentAt:
          type: string
          format: date-time
          description: Quote sent timestamp
        acceptedAt:
          type: string
          format: date-time
          description: Quote acceptance timestamp
    Allocation:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Allocation identifier
        clientId:
          type: string
          format: uuid
          description: Client identifier
        poolId:
          type: string
          format: uuid
          description: Liquidity pool identifier
        poolAccountId:
          type: string
          format: uuid
          description: Pool account identifier
        allocatedAmount:
          type: number
          description: Amount allocated from this provider
          example: 31.65
        sourceAmount:
          type: number
          description: Source amount for this allocation
          example: 50000
        rate:
          type: number
          description: Exchange rate for this allocation
          example: 1580.5
        reference:
          type: string
          description: Allocation reference code
          example: REF-001
        metadata:
          type: object
          description: Additional allocation metadata
          additionalProperties:
            type: string
    BankPayInDetails:
      type: object
      properties:
        accountName:
          type: string
          description: Bank account name
          example: Spotflow Ltd
        accountNumber:
          type: string
          description: Bank account number
          example: '0123456789'
        bankName:
          type: string
          description: Bank name
          example: Access Bank
        reference:
          type: string
          description: Payment reference
          example: PAY-REF-001
    CryptoPayInDetails:
      type: object
      properties:
        addressId:
          type: string
          format: uuid
          description: Address identifier
        address:
          type: string
          description: Blockchain wallet address
          example: '0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5'
        chain:
          type: string
          description: Blockchain network
          example: BASE
        token:
          type: string
          description: Token symbol
          example: USDT
        addressType:
          type: string
          description: Address type
          example: deposit
        expectedAmount:
          type: number
          description: Expected deposit amount
          example: 50000
        externalReference:
          type: string
          description: External reference ID
        status:
          type: string
          description: Address status
          enum:
            - active
            - pending
            - expired
          example: active
        createdAt:
          type: string
          format: date-time
          description: Address creation timestamp
          example: '2026-04-01T10:55:46.254Z'
        expiresAt:
          type: string
          format: date-time
          description: Address expiration timestamp
          example: '2026-04-01T10:55:46.256Z'
        virtualAccountId:
          type: string
          description: Virtual account identifier
        derivationIndex:
          type: integer
          description: HD wallet derivation index
          example: 0
        warningMessage:
          type: string
          description: Warning message for user
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: API key authentication using Bearer token

````