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

# Find all message templates.

> Find the message templates of a project that are visible to the calling agent (public templates plus
templates shared with them), ordered by `lexorank`.



## OpenAPI

````yaml https://api.gleap.io/api-docs.json get /message-templates
openapi: 3.0.0
info:
  title: gleap-server
  version: 14.0.0
  contact: {}
servers:
  - url: https://api.gleap.io/v3
security: []
paths:
  /message-templates:
    get:
      tags:
        - Message templates
      summary: Find all message templates.
      description: >-
        Find the message templates of a project that are visible to the calling
        agent (public templates plus

        templates shared with them), ordered by `lexorank`.
      operationId: FindMessageTemplates
      parameters:
        - in: header
          name: project
          required: true
          schema:
            type: string
        - description: >-
            - Maximum number of templates to return; unlimited when omitted
            (with `searchTerm`: default 25, max 50).
          in: query
          name: limit
          required: false
          schema:
            type: number
            format: double
        - description: '- Number of templates to skip.'
          in: query
          name: skip
          required: false
          schema:
            type: number
            format: double
        - description: >-
            - Matches the template title first, then body text. Search results
            are capped (default 25, max 50) and include `matchedIn` and
            `matchSnippet`.
          in: query
          name: searchTerm
          required: false
          schema:
            type: string
        - description: >-
            - `public` for public templates only, `private` for non-public
            templates shared with the caller; omit for both.
          in: query
          name: visibility
          required: false
          schema:
            type: string
        - description: '- Return `{ data, totalCount }` instead of a plain array.'
          in: query
          name: withCount
          required: false
          schema:
            type: boolean
        - description: >-
            - Apply usage restrictions: exclude templates limited to teams the
            caller is not a member of. Sent by the template pickers; the
            settings pages omit it so restricted templates stay manageable.
          in: query
          name: forUsage
          required: false
          schema:
            type: boolean
        - description: '- Exclude templates limited to other ticket types.'
          in: query
          name: ticketType
          required: false
          schema:
            type: string
        - description: '- Only templates carrying this tag.'
          in: query
          name: tag
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                anyOf:
                  - items: {}
                    type: array
                  - properties:
                      totalCount:
                        type: number
                        format: double
                      data:
                        items: {}
                        type: array
                    required:
                      - totalCount
                      - data
                    type: object
      security:
        - jwt: []
components:
  securitySchemes:
    jwt:
      type: http
      scheme: bearer
      bearerFormat: JWT

````