# app.rocksky.equalizer.putPreset

> Published by [rocksky.app](https://lexicon.garden/identity/did:plc:vegqomyce4ssoqs7zwqvgqty)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.equalizer.putPreset)
- [Documentation](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.equalizer.putPreset/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.equalizer.putPreset/examples)

## Definitions

### `app.rocksky.equalizer.putPreset`

**Type**: `procedure`

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.

#### Input

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `bands` | `array` | Yes | Up to 10 EQ bands |
| `name` | `string` | Yes | Display name of the preset. |
| `precut` | `integer` | No | Pre-amplification cut in tenths of dB applied before EQ bands (e.g. -60 = -6.0 dB) |

#### Output

**Encoding**: `application/json`

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "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.",
      "input": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "bands": {
              "description": "Up to 10 EQ bands",
              "items": {
                "ref": "app.rocksky.rockbox.defs#equalizerBand",
                "type": "ref"
              },
              "type": "array"
            },
            "name": {
              "description": "Display name of the preset.",
              "maxLength": 64,
              "minLength": 1,
              "type": "string"
            },
            "precut": {
              "description": "Pre-amplification cut in tenths of dB applied before EQ bands (e.g. -60 = -6.0 dB)",
              "maximum": 0,
              "minimum": -240,
              "type": "integer"
            }
          },
          "required": [
            "name",
            "bands"
          ],
          "type": "object"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "ref": "app.rocksky.equalizer.defs#presetView",
          "type": "ref"
        }
      },
      "type": "procedure"
    }
  },
  "id": "app.rocksky.equalizer.putPreset",
  "lexicon": 1
}
```