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

# List Agent Composer Templates

> Retrieve a list of all available Agent Composer Templates.



## OpenAPI

````yaml api-reference/openapi.json get /agents/templates/acl
openapi: 3.1.0
info:
  title: Endpoints
  version: '1.0'
servers:
  - url: https://api.contextual.ai/v1
security:
  - BearerAuth: []
paths:
  /agents/templates/acl:
    get:
      tags:
        - /agents
      summary: List Agent Composer Templates
      description: Retrieve a list of all available Agent Composer Templates.
      operationId: list_acl_templates_agents_templates_acl_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListACLTemplatesResponse'
components:
  schemas:
    ListACLTemplatesResponse:
      properties:
        templates:
          items:
            $ref: '#/components/schemas/ACLTemplateEntry'
          type: array
          title: Templates
          description: List of available Agent Composer templates.
          default: []
      type: object
      title: ListACLTemplatesResponse
    ACLTemplateEntry:
      properties:
        id:
          type: string
          title: Id
          description: Unique identifier for the Agent Composer template
        name:
          type: string
          title: Name
          description: Display name of the template
        description:
          type: string
          title: Description
          description: Description of what this template is for
        badges:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Badges
          description: >-
            Optional badge identifiers for UI presentation (e.g.,
            'dynamic-agent')
        template_name:
          type: string
          title: Template Name
          description: The DB template name to use (e.g., 'finance', 'default')
        acl_config_name:
          $ref: '#/components/schemas/ACLConfigName'
          description: >-
            The Agent Composer config name to use (e.g., 'default_query',
            'datastore_search')
      type: object
      required:
        - id
        - name
        - description
        - template_name
        - acl_config_name
      title: ACLTemplateEntry
      description: An Agent Composer template entry with metadata
    ACLConfigName:
      type: string
      enum:
        - default_query
        - datastore_search
        - web_search
        - meta_queries
        - structured_unstructured_search
        - default_query_fine_grained
        - conditional
        - instant_search_test
        - root_cause_analysis
      title: ACLConfigName
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````