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

# List template versions

> Returns raw authored template versions without inheritance resolution or section expansion.
To see resolved content, use GET /documents/templates/{templateID} instead.




## OpenAPI

````yaml /api-reference/auto-generated-openapi.yml get /documents/templates/{templateID}/versions/
openapi: 3.0.0
info:
  title: Corti API
  version: 2.0.0
servers:
  - url: https://api.{environment}.corti.app/v2/
    variables:
      environment:
        default: eu
        enum:
          - us
          - eu
security:
  - AuthorizationHeader:
      - bearer
tags:
  - name: Interactions
  - name: Recordings
  - name: Transcripts
  - name: Facts
  - name: Codes
  - name: Languages
  - name: Guided Documents
  - name: Guided Templates
  - name: Guided Sections
  - name: Documents (Classic)
  - name: Templates (Classic)
paths:
  /documents/templates/{templateID}/versions/:
    parameters:
      - $ref: '#/components/parameters/Tenant-Name'
      - $ref: '#/components/parameters/GuidedTemplateId'
    get:
      tags:
        - Guided Templates
      summary: List template versions
      description: >
        Returns raw authored template versions without inheritance resolution or
        section expansion.

        To see resolved content, use GET /documents/templates/{templateID}
        instead.
      operationId: guided_templates_versions_list
      responses:
        '200':
          description: OK — returns shallow (unresolved) template versions
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GuidedShallowTemplateVersionResponse'
        '404':
          $ref: '#/components/responses/NotFound'
      x-codeSamples:
        - lang: csharp
          label: C# .NET SDK
          source: |
            using Corti;

            var client = new CortiClient(
                "TENANT_NAME",
                CortiClientEnvironment.Eu,
                new CortiClientAuth.ClientCredentials("client_id", "client_secret")
            );
            await client.Documents.Templates.Versions.ListAsync("templateID");
        - lang: javascript
          label: JavaScript SDK
          source: |
            import { CortiClient, CortiEnvironment } from "@corti/sdk";

            const client = new CortiClient({
                environment: CortiEnvironment.Eu,
                auth: {
                    clientId: "YOUR_CLIENT_ID",
                    clientSecret: "YOUR_CLIENT_SECRET"
                },
                tenantName: "YOUR_TENANT_NAME"
            });
            await client.documents.templates.versions.list("templateID");
components:
  parameters:
    Tenant-Name:
      name: Tenant-Name
      in: header
      description: >-
        Identifies a distinct entity within Corti's multi-tenant system. Ensures
        correct routing and authentication of the request.
      required: true
      example: base
      schema:
        type: string
        description: >-
          Identifies a distinct entity within Corti's multi-tenant system.
          Ensures correct routing and authentication of the request.
        example: base
    GuidedTemplateId:
      name: templateID
      in: path
      required: true
      schema:
        type: string
        format: uuid
  schemas:
    GuidedShallowTemplateVersionResponse:
      type: object
      description: >
        Template version with raw authored values — no inheritance resolution
        applied.

        Sections are returned as references (IDs), not fully resolved objects.

        Use this to inspect what was explicitly set on this version versus
        inherited.

        Returned by GET, LIST, and POST version endpoints.
      required:
        - id
        - versionNumber
        - generation
      properties:
        id:
          description: The UUID of the version.
          type: string
          format: uuid
        versionNumber:
          description: Starts at 0 and auto-increments.
          type: integer
        deletedAt:
          description: Present when the template version has been deleted.
          type: string
          format: date-time
          nullable: true
        generation:
          $ref: '#/components/schemas/GuidedShallowTemplateGeneration'
    GuidedShallowTemplateGeneration:
      type: object
      description: >-
        Template generation with section references (not fully resolved). Use
        the resolved GuidedTemplateGeneration for hydrated section data.
      required:
        - instructions
        - sections
      properties:
        instructions:
          $ref: '#/components/schemas/GuidedTemplateInstructions'
        sections:
          description: Section references linked to this version (not fully resolved).
          type: array
          items:
            $ref: '#/components/schemas/GuidedTemplateVersionSectionRef'
    ErrorResponse:
      type: object
      required:
        - requestid
        - status
        - type
        - detail
      properties:
        requestid:
          type: string
        status:
          type: integer
        type:
          type: string
        detail:
          type: string
        validationErrors:
          type: array
          items:
            type: object
            additionalProperties:
              type: string
    GuidedTemplateInstructions:
      type: object
      required:
        - prompt
      properties:
        prompt:
          type: string
          description: >-
            Template-level prompt instructions that apply generally to all
            sections.
    GuidedTemplateVersionSectionRef:
      type: object
      required:
        - sectionId
        - orderIndex
      properties:
        sectionId:
          description: The UUID of the section linked to this template version.
          type: string
          format: uuid
        orderIndex:
          description: The ordering position of the section within the template version.
          type: integer
  responses:
    NotFound:
      description: Not Found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    AuthorizationHeader:
      type: http
      description: Input your token
      scheme: bearer

````