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

# List harmony presets

> Returns Audimee's harmony presets, the same ones offered in the harmony maker. Each preset is a set of 1–5 tracks; every track has a built-in voice, the line it sings and an octave shift. Pass a preset's `id` as `presetId` to `POST /harmonies`.



## OpenAPI

````yaml GET /harmony-presets
openapi: 3.1.0
info:
  title: Audimee API
  description: >-
    The Audimee API lets clients browse voice models, train custom voices, run
    AI voice conversions, and create multi-voice harmonies.
  version: 1.0.0
servers:
  - url: https://audimee.com/api/v1
security:
  - bearerAuth: []
paths:
  /harmony-presets:
    get:
      tags:
        - Harmonies
      summary: List harmony presets
      description: >-
        Returns Audimee's harmony presets, the same ones offered in the harmony
        maker. Each preset is a set of 1–5 tracks; every track has a built-in
        voice, the line it sings and an octave shift. Pass a preset's `id` as
        `presetId` to `POST /harmonies`.
      operationId: listHarmonyPresets
      responses:
        '200':
          description: All harmony presets.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/HarmonyPreset'
              example:
                - id: '1'
                  name: Poppy Thirds And Fifths
                  tracks:
                    - voiceModelId: '101'
                      harmonyKey: Root Drone
                      octaveShift: 0
                    - voiceModelId: '113'
                      harmonyKey: + Third
                      octaveShift: 0
                    - voiceModelId: '129'
                      harmonyKey: + Fifth
                      octaveShift: 0
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    HarmonyPreset:
      type: object
      required:
        - id
        - name
        - tracks
      properties:
        id:
          type: string
          description: >-
            Stable identifier of the preset. Pass it as `presetId` to `POST
            /harmonies`.
        name:
          type: string
          description: >-
            Display name of the preset, as shown in the harmony maker. May be
            reworded over time; use `id` to refer to a preset.
        tracks:
          type: array
          description: >-
            The voices this preset produces, 1–5 of them. Each becomes one track
            of the harmony.
          items:
            $ref: '#/components/schemas/HarmonyPresetTrack'
    HarmonyPresetTrack:
      type: object
      required:
        - voiceModelId
        - harmonyKey
        - octaveShift
      properties:
        voiceModelId:
          type: string
          description: >-
            ID of the built-in Audimee voice that sings this track. Look it up
            with `GET /voice-models/{id}`.
        harmonyKey:
          $ref: '#/components/schemas/HarmonyKey'
        octaveShift:
          type: integer
          description: >-
            Whole octaves the track is moved up or down after the interval is
            applied. `0` leaves it where the interval puts it.
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable explanation of what went wrong.
    HarmonyKey:
      type: string
      enum:
        - Melody
        - + Third
        - '- Third'
        - + Fourth
        - '- Fourth'
        - + Fifth
        - '- Fifth'
        - + Sixth
        - '- Sixth'
        - Root Drone
        - 3rd Drone
        - 5th Drone
      description: >-
        The line a track sings, relative to the input melody. `Melody` doubles
        the input. `+`/`-` intervals follow the melody a third, fourth, fifth or
        sixth above or below it, staying on the notes of the harmony's `key`.
        Drones hold a single note of the key — its root, third or fifth — for
        the whole take.
  responses:
    Unauthorized:
      description: Missing, malformed, or unrecognised bearer token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            missingHeader:
              summary: No Authorization header
              value:
                error: Missing or invalid Authorization header
            invalidToken:
              summary: Token not recognised
              value:
                error: Invalid authorization token
            userNotFound:
              summary: Token valid but user no longer exists
              value:
                error: User not found
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Static API key issued by Audimee, passed as `Authorization: Bearer
        {token}`.

````

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