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

# List behavior presets

> List the catalog of behavior presets that can be referenced from a BatchConfig using the preset:<identifier> syntax.



## OpenAPI

````yaml api/velma_2_batch.yaml GET /api/velma-2-batch/list-presets
openapi: 3.1.0
info:
  title: Modulate Velma-2 Batch Server
  version: 0.0.0
  description: |
    Batch endpoint for the velma-2 service. Accepts a multipart upload with an
    audio file and a JSON `config` blob describing the conversation types,
    participant roles, and behaviors to use for analysis. Returns the full
    transcribed-and-analyzed conversation in one response (clips,
    conversation-type pick, participant-role picks, behaviors, topics, topic
    sentiments, and an optional summary).
servers:
  - url: https://platform.modulate.ai
    description: Modulate Velma-2 Batch Server
security:
  - ApiKeyAuth: []
paths:
  /api/velma-2-batch/list-presets:
    get:
      summary: List available behavior presets.
      description: |
        Returns the catalog of behavior presets that can be referenced
        from the `behaviors` array in a BatchConfig using the
        `preset:<identifier>` syntax. Each entry includes the preset
        `identifier`, `name`, `short_description`, and
        `detailed_description`.
      operationId: velma2BatchListPresets
      responses:
        '200':
          description: List of premade presets.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPresetsResponse'
        '403':
          description: Forbidden - the request is not permitted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: This request is not permitted.
        '429':
          description: >-
            Too many requests - the request could not be completed due to
            insufficient credits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: Insufficient credits.
        '502':
          description: Bad gateway - the request could not be validated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: Unable to validate request. Please try again.
components:
  schemas:
    ListPresetsResponse:
      type: object
      required:
        - presets
      properties:
        presets:
          type: array
          items:
            $ref: '#/components/schemas/BehaviorPresetListing'
    ErrorResponse:
      type: object
      required:
        - detail
      properties:
        detail:
          type: string
          description: Human-readable error message describing what went wrong
    BehaviorPresetListing:
      type: object
      required:
        - identifier
        - name
        - short_description
        - detailed_description
      properties:
        identifier:
          type: string
          description: |
            The preset identifier to use in a `preset:<identifier>`
            behavior reference.
        name:
          type: string
        short_description:
          type: string
        detailed_description:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key used for authentication and usage tracking.

````