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

# Delete a fair value

> Future extension. Delete one private fair-value record by its Rook record ID. Authorization must grant access to its owner and scope. Supply if_revision to reject deletion if the record has changed since it was read.

Success returns 204 with no response body. Deleting the estimate does not delete its market, modify settlement payouts or change positions.

*Future extension.*

See the [integration guide](/guides/fair-values) for the workflow and interpretation of this response.


## OpenAPI

````yaml DELETE /fair-values/{id}
openapi: 3.1.0
info:
  title: Rook API
  version: 0.1.0-design
  description: Markets, settlement relationships, scenarios, payouts and market data.
servers:
  - url: https://api.rook.pm/v1
    description: Proposed API origin; not an assertion these operations are callable.
security:
  - ApiKeyBearer: []
tags:
  - name: Reference data
    description: Events, unified markets and native-ID resolution.
  - name: Families and scenarios
    description: Family scope and versioned scenario columns.
  - name: Relationships and Combos
    description: Related-market discovery, selected-set inference and Combo interpretation.
  - name: Payouts and exposure
    description: Scoped per-unit payouts and stateless portfolio/candidate calculations.
  - name: Market data
    description: Current prices, history, L2 books, prints, statistics and published fees.
  - name: Fair values
    description: Future private customer estimates; not Rook forecasts.
  - name: Coverage and updates
    description: Supported capabilities and incremental semantic changes.
paths:
  /fair-values/{id}:
    delete:
      tags:
        - Fair values
      summary: Delete a fair value
      description: >-
        Future extension. Delete one private fair-value record by its Rook
        record ID. Authorization must grant access to its owner and scope.
        Supply if_revision to reject deletion if the record has changed since it
        was read.


        Success returns 204 with no response body. Deleting the estimate does
        not delete its market, modify settlement payouts or change positions.
      operationId: deleteFairValue
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            description: Opaque text identifier. Preserve its exact value.
            minLength: 1
          description: >-
            Rook ID of the private fair-value record to delete, obtained from
            the save or list response.
          example: fv_rates_cut_desk
        - name: if_revision
          in: query
          required: false
          description: >-
            Only delete if the saved record still has this server revision; a
            mismatch returns a conflict.
          schema:
            type: string
            description: Opaque text identifier. Preserve its exact value.
            minLength: 1
          example: '1'
        - name: X-Client-Request-Id
          in: header
          required: false
          schema:
            type: string
          description: Caller correlation reference; not an idempotency guarantee.
      responses:
        '204':
          description: Success.
          headers:
            X-Request-Id:
              description: Server request trace ID.
              schema:
                type: string
                description: Opaque text identifier. Preserve its exact value.
                minLength: 1
components:
  securitySchemes:
    ApiKeyBearer:
      type: http
      scheme: bearer
      description: >-
        Proposed server-to-server API key. No client request HMAC signing scheme
        is specified.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.