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

# List Templates

> Returns all WhatsApp Templates



## OpenAPI

````yaml api-reference/openapi.json get /api/v1/whatsapp-templates/
openapi: 3.0.3
info:
  title: Wassist API
  version: 1.0.0
  description: API for building WhatsApp AI agents
servers:
  - url: https://backend.wassist.app
    description: Production
  - url: http://localhost:8050
    description: Development
security: []
tags:
  - name: Agents
    description: Create and manage AI agents
  - name: Conversations
    description: Chat conversations and messages
  - name: WhatsApp
    description: WhatsApp Business account management
  - name: Contacts
    description: Contact management
  - name: Integrations
    description: Third-party integrations
paths:
  /api/v1/whatsapp-templates/:
    get:
      tags:
        - api
      description: >-
        ViewSet for managing local WhatsApp Message Templates.


        Templates can be created as drafts, then published to one or more
        WhatsApp Business Accounts.

        Status updates are received via webhooks from Meta.


        Endpoints:

        - GET /whatsapp-templates/ - List all templates with account links

        - POST /whatsapp-templates/ - Create a new template (draft)

        - GET /whatsapp-templates/{id}/ - Get template details with account
        statuses

        - PATCH /whatsapp-templates/{id}/ - Update template

        - DELETE /whatsapp-templates/{id}/ - Delete template and all links

        - POST /whatsapp-templates/{id}/publish/ - Publish to specific
        account(s)

        - POST /whatsapp-templates/{id}/unpublish/ - Remove from specific
        account(s)
      operationId: api_v1_whatsapp_templates_list
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/WhatsAppTemplateLocal'
          description: ''
      security:
        - ApiKeyAuth: []
components:
  schemas:
    WhatsAppTemplateLocal:
      type: object
      description: Serializer for local WhatsApp templates with account links.
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        name:
          type: string
          maxLength: 512
        category:
          $ref: '#/components/schemas/WhatsAppTemplateLocalCategoryEnum'
        language:
          type: string
          maxLength: 10
        parameterFormat:
          type: string
        components: {}
        accountLinks:
          type: array
          items:
            $ref: '#/components/schemas/WhatsAppTemplateAccountLink'
          readOnly: true
        createdAt:
          type: string
          format: date-time
          readOnly: true
        updatedAt:
          type: string
          format: date-time
          readOnly: true
      required:
        - accountLinks
        - category
        - createdAt
        - id
        - name
        - parameterFormat
        - updatedAt
    WhatsAppTemplateLocalCategoryEnum:
      enum:
        - UTILITY
        - MARKETING
        - AUTHENTICATION
      type: string
      description: |-
        * `UTILITY` - Utility
        * `MARKETING` - Marketing
        * `AUTHENTICATION` - Authentication
    WhatsAppTemplateAccountLink:
      type: object
      description: Serializer for template-to-account links with status tracking.
      properties:
        accountId:
          type: string
          format: uuid
          readOnly: true
        accountName:
          type: string
          readOnly: true
        wabaId:
          type: string
          readOnly: true
        metaTemplateId:
          type: string
          readOnly: true
        status:
          $ref: '#/components/schemas/WhatsAppTemplateAccountLinkStatusEnum'
        qualityScore:
          type: string
          readOnly: true
        rejectionReason:
          type: string
          readOnly: true
      required:
        - accountId
        - accountName
        - metaTemplateId
        - qualityScore
        - rejectionReason
        - wabaId
    WhatsAppTemplateAccountLinkStatusEnum:
      enum:
        - DRAFT
        - PENDING
        - APPROVED
        - REJECTED
        - PAUSED
      type: string
      description: |-
        * `DRAFT` - Draft
        * `PENDING` - Pending
        * `APPROVED` - Approved
        * `REJECTED` - Rejected
        * `PAUSED` - Paused
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key authentication. Pass your API key in the X-API-Key header.

````