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

# List available sidekicks

> List the sidekicks you can select on a submission.

Returns each sidekick's id, name, description, and the asset types it
processes. Use the ``id`` values in the ``sidekickIds`` of
``POST /submissions``; the ``supportedAssetTypes`` tell you which file
types each one accepts — an asset whose type no selected sidekick supports
is rejected at submit time.

Sidekicks your workspace has deactivated are omitted. Ordered by name.

Authentication: Requires X-API-Key header with valid API key.



## OpenAPI

````yaml get /api/integrations/sidekicks
openapi: 3.1.0
info:
  title: Midmarket Integrations API
  description: An API for Midmarket integrations.
  version: 0.1.0
servers:
  - url: https://mm-midmarket-integrations-api-preview.azurewebsites.net
    description: preview
security: []
paths:
  /api/integrations/sidekicks:
    get:
      tags:
        - sidekicks
      summary: List available sidekicks
      description: >-
        List the sidekicks you can select on a submission.


        Returns each sidekick's id, name, description, and the asset types it

        processes. Use the ``id`` values in the ``sidekickIds`` of

        ``POST /submissions``; the ``supportedAssetTypes`` tell you which file

        types each one accepts — an asset whose type no selected sidekick
        supports

        is rejected at submit time.


        Sidekicks your workspace has deactivated are omitted. Ordered by name.


        Authentication: Requires X-API-Key header with valid API key.
      operationId: list_sidekicks_api_integrations_sidekicks_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/SidekickSchema'
                type: array
                title: Response List Sidekicks Api Integrations Sidekicks Get
      security:
        - apiKey: []
components:
  schemas:
    SidekickSchema:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Pass this in the submission's sidekickIds.
        name:
          type: string
          title: Name
          description: Human-readable sidekick name.
        description:
          type: string
          title: Description
          description: Short one-line summary.
        longDescription:
          type: string
          title: Longdescription
          description: Full description of what the sidekick checks.
        icon:
          type: string
          title: Icon
          description: Lucide icon name, e.g. 'FileText'.
        tags:
          items:
            type: string
          type: array
          title: Tags
          description: Free-form classification tags.
          default: []
        supportedAssetTypes:
          items:
            type: string
          type: array
          title: Supportedassettypes
          description: >-
            Asset types this sidekick can process: 'video', 'document',
            'script', 'image'. Submitting an asset whose type is not in this
            list for every selected sidekick is rejected at submit time.
          default: []
      type: object
      required:
        - id
        - name
        - description
        - longDescription
        - icon
      title: SidekickSchema
      description: A sidekick the workspace can run, with the asset types it handles.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'Workspace-scoped API key. Format: sk_live_{64 hex chars}'
      x-default: sk_live_your_api_key_here

````