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

# Get Templates

> Returns the list of pre-built agent configuration templates.
Each template includes an id, name, and description. Use the
`applyTemplate` endpoint to retrieve the full configuration for a template.
Requires `agent_config:view` permission.




## OpenAPI

````yaml GET /api/agent-config/templates
openapi: 3.1.0
info:
  title: Naturalead Agent Config API
  version: 1.0.0
  description: >
    API for managing AI agent configurations in the Naturalead platform.

    Agent configs define how the AI converses with leads, including the system
    prompt,

    conversation stages, guardrails, and attached knowledge bases.


    All endpoints require API key authentication and are scoped to the caller's
    account.
servers:
  - url: '{baseUrl}'
    description: API server
    variables:
      baseUrl:
        default: http://localhost:3001
security:
  - BearerAuth: []
tags:
  - name: Agent Config
    description: AI agent configuration CRUD, templates, and knowledge base assignment
  - name: Templates
    description: Pre-built agent configuration templates
  - name: Knowledge Bases
    description: Attach and detach knowledge bases from agents
paths:
  /api/agent-config/templates:
    get:
      tags:
        - Templates
      summary: Get templates
      description: >
        Returns the list of pre-built agent configuration templates.

        Each template includes an id, name, and description. Use the

        `applyTemplate` endpoint to retrieve the full configuration for a
        template.

        Requires `agent_config:view` permission.
      operationId: getTemplates
      responses:
        '200':
          description: Available templates
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Template'
components:
  schemas:
    Template:
      type: object
      properties:
        id:
          type: string
          description: Template identifier
        name:
          type: string
          description: Template display name
        description:
          type: string
          description: Brief description of the template's purpose
      required:
        - id
        - name
        - description
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Bearer token using an API key (format nl_live_* or nl_test_*)

````