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

# List templates as Extended Markdown (legacy)

> Legacy bulk response retained for API compatibility. New AI and MCP clients should use GET /dev/templates and fetch one selected template through /:templateId/markdown.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/dev/templates/markdown
openapi: 3.0.0
info:
  title: Autype Developer API
  description: >-
    Autype Developer API for programmatic document generation.


    ## Authentication

    Use an API key in `X-API-Key`. Autype's trusted MCP service may instead use
    a short-lived, Developer-API-audience OAuth token obtained through
    server-side token exchange. Raw MCP resource tokens, login JWTs, and
    third-party tokens are not accepted.


    ## Rate Limiting

    API requests are rate-limited to 100 requests per minute per API key.


    ## Automation Credits

    Developer API rendering and bulk operations consume automation credits from
    your organization. AI documents, assistant tasks, translations, and AI
    images use separate plan allowances.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.autype.com
    description: Production
security: []
tags:
  - name: Temporary Images
    description: Upload and manage temporary images for document rendering
  - name: Render
    description: Render documents to PDF, DOCX, ODT, or page images
  - name: Bulk Render
    description: Bulk document generation with variable substitution
  - name: Documents
    description: Document variable inspection
  - name: Projects
    description: List organization projects
paths:
  /api/v1/dev/templates/markdown:
    get:
      tags:
        - developer-api
      summary: List templates as Extended Markdown (legacy)
      description: >-
        Legacy bulk response retained for API compatibility. New AI and MCP
        clients should use GET /dev/templates and fetch one selected template
        through /:templateId/markdown.
      operationId: DeveloperTemplatesController_listMarkdown_v1
      parameters:
        - name: category
          required: true
          in: query
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TemplateMarkdownResponseDto'
      deprecated: true
      security:
        - mcp-oauth: []
        - api-key: []
components:
  schemas:
    TemplateMarkdownResponseDto:
      type: object
      properties:
        id:
          type: string
          example: 550e8400-e29b-41d4-a716-446655440000
        scope:
          type: string
          enum:
            - workspace
            - catalog
        productive:
          type: boolean
        name:
          type: string
          example: Business Report
        slug:
          type: string
          example: business-report
        description:
          type: object
          example: Professional business report template
        category:
          type: string
          example: business
        previewImage:
          type: object
          example: /templates/business-report-preview.png
        pdfUrl:
          type: object
          example: /api/v1/templates/{id}/pdf
        markdown:
          type: string
          description: >-
            Template content converted to Autype Extended Markdown. This is the
            preferred format for agents.
        format:
          type: string
          enum:
            - markdown
            - json_fallback
          description: >-
            Whether the template content could be converted to Extended Markdown
            or had to fall back to compact JSON.
        warning:
          type: string
          description: Warning when conversion could not produce Extended Markdown.
        config:
          type: object
          description: >-
            Original template JSON config. Use only for advanced clients; agents
            should prefer markdown.
        createdAt:
          format: date-time
          type: string
        updatedAt:
          format: date-time
          type: string
      required:
        - id
        - scope
        - productive
        - name
        - slug
        - category
        - markdown
        - format
        - config
        - createdAt
        - updatedAt
  securitySchemes:
    mcp-oauth:
      scheme: bearer
      bearerFormat: Autype Developer API OAuth token
      type: http
      description: >-
        Short-lived, Developer-API-audience token obtained by the trusted MCP
        service through token exchange (mcp_at_...). Raw MCP resource tokens are
        rejected.
    api-key:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key (starts with ak_...)

````