> ## 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 organization reusable blocks

> Returns reusable document blocks. Use their markdown for AI workflows or insert them as snapshot/reference blocks.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/dev/reusable-blocks
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/reusable-blocks:
    get:
      tags:
        - developer-api
      summary: List organization reusable blocks
      description: >-
        Returns reusable document blocks. Use their markdown for AI workflows or
        insert them as snapshot/reference blocks.
      operationId: ReusableBlocksController_list_v1
      parameters:
        - name: query
          required: true
          in: query
          schema:
            type: string
        - name: category
          required: true
          in: query
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ReusableBlockResponseDto'
      security:
        - mcp-oauth: []
        - api-key: []
components:
  schemas:
    ReusableBlockResponseDto:
      type: object
      properties:
        id:
          type: string
        orgId:
          type: string
        name:
          type: string
        slug:
          type: string
        description:
          type: string
          nullable: true
        category:
          type: string
        tags:
          type: array
          items:
            type: string
        status:
          type: string
          enum:
            - DRAFT
            - ACTIVE
            - ARCHIVED
        currentVersion:
          type: number
        createdByUserId:
          type: string
          nullable: true
        createdAt:
          format: date-time
          type: string
        updatedAt:
          format: date-time
          type: string
        current:
          $ref: '#/components/schemas/ReusableBlockVersionResponseDto'
        versions:
          type: array
          items:
            $ref: '#/components/schemas/ReusableBlockVersionResponseDto'
      required:
        - id
        - orgId
        - name
        - slug
        - category
        - tags
        - status
        - currentVersion
        - createdAt
        - updatedAt
    ReusableBlockVersionResponseDto:
      type: object
      properties:
        id:
          type: string
        blockId:
          type: string
        version:
          type: number
        title:
          type: string
        markdown:
          type: string
        schema:
          type: object
          description: Validated JSON content generated from the block markdown.
        variables:
          type: object
        changeNote:
          type: string
          nullable: true
        restoredFromVersion:
          type: number
          nullable: true
        createdByUserId:
          type: string
          nullable: true
        createdAt:
          format: date-time
          type: string
      required:
        - id
        - blockId
        - version
        - title
        - markdown
        - schema
        - variables
        - createdAt
  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_...)

````