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

# Create or update one of the authenticated user's equalizer presets. The record key is derived from the name (lower case, dashes, no spaces), so saving with an existing name overwrites that preset.



## OpenAPI

````yaml /api-reference/openapi.json post /app.rocksky.equalizer.putPreset
openapi: 3.1.0
info:
  title: Rocksky XRPC API
  version: 1.0.0
  description: >-
    Generated from the registered Rocksky XRPC handlers and current lexicons.
    Provider-defined payloads remain open schemas. Some handlers return empty
    fallback objects on service failures. This reference describes the
    repository implementation; production may run an earlier revision.
  license:
    name: MIT License
    identifier: MIT
servers:
  - url: https://api.rocksky.app/xrpc
    description: Rocksky API
security: []
paths:
  /app.rocksky.equalizer.putPreset:
    post:
      tags:
        - app.rocksky.equalizer
      summary: >-
        Create or update one of the authenticated user's equalizer presets. The
        record key is derived from the name (lower case, dashes, no spaces), so
        saving with an existing name overwrites that preset.
      operationId: app.rocksky.equalizer.putPreset
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Display name of the preset.
                  minLength: 1
                  maxLength: 64
                precut:
                  type: integer
                  description: >-
                    Pre-amplification cut in tenths of dB applied before EQ
                    bands (e.g. -60 = -6.0 dB)
                  minimum: -240
                  maximum: 0
                bands:
                  type: array
                  items:
                    $ref: >-
                      #/components/schemas/app.rocksky.rockbox.defs__equalizerBand
                  description: Up to 10 EQ bands
              required:
                - name
                - bands
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app.rocksky.equalizer.defs__presetView'
        '400':
          description: Invalid XRPC request or parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/XrpcError'
        default:
          description: XRPC error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/XrpcError'
      security:
        - Bearer: []
components:
  schemas:
    app.rocksky.rockbox.defs__equalizerBand:
      type: object
      properties:
        frequency:
          type: integer
          description: Center frequency in Hz
          minimum: 20
          maximum: 22000
        gain:
          type: integer
          description: Band gain in tenths of dB (e.g. 30 = +3.0 dB)
          minimum: -240
          maximum: 240
        q:
          type: integer
          description: Q factor × 10 (e.g. 7 = Q 0.7)
          minimum: 5
          maximum: 640
      required:
        - frequency
        - gain
        - q
    app.rocksky.equalizer.defs__presetView:
      type: object
      properties:
        uri:
          type: string
          description: AT URI of the preset record.
          x-lexicon-format: at-uri
        rkey:
          type: string
          description: >-
            Record key: the preset name slugified (lower case, dashes, no
            spaces).
        name:
          type: string
          description: Display name of the preset.
        precut:
          type: integer
          description: >-
            Pre-amplification cut in tenths of dB applied before EQ bands (e.g.
            -60 = -6.0 dB)
          minimum: -240
          maximum: 0
        bands:
          type: array
          items:
            $ref: '#/components/schemas/app.rocksky.rockbox.defs__equalizerBand'
          description: Up to 10 EQ bands
        createdAt:
          type: string
          description: When this preset was first created.
          format: date-time
        updatedAt:
          type: string
          description: When this preset was last updated.
          format: date-time
      required:
        - uri
        - rkey
        - name
        - bands
        - createdAt
    XrpcError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
        message:
          type: string
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      description: Rocksky bearer token.

````

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