> ## 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'
        '401':
          description: Unauthorized - the API key is missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                missing_api_key:
                  summary: API key header absent
                  value:
                    detail: Missing API key.
                invalid_api_key:
                  summary: API key not recognized
                  value:
                    detail: Invalid API key.
        '403':
          description: Forbidden - the request is not permitted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                not_permitted:
                  summary: Request not permitted
                  value:
                    detail: This request is not permitted.
                model_access_denied:
                  summary: API key lacks access to this model
                  value:
                    detail: This API key does not have access to this model.
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: Internal server error
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.

````

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