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

# List public plugins

> Public, unauthenticated listing of the visible plugin catalog. Only
non-sensitive fields are returned — credentials, tokens, and other
internal configuration are never included.



## OpenAPI

````yaml /api/services-api.yaml get /v1/plugins/public
openapi: 3.0.3
info:
  description: >-
    Talqui is an omnichannel customer service platform that unifies
    conversations from WhatsApp, Instagram, Telegram, and many other channels
    into a single attendant panel, alongside a broader ecosystem of plugins and
    integrations. This API gives developers programmatic access to Talqui's
    services layer, exposing the operations needed to read and manage tenants,
    conversations, plugins, and related resources that power that platform.


    Authentication is available on behalf of an Operator (the default for this
    API), a Plugin Connection, or a Plugin — see the [Talqui authentication
    guide](https://docs.talqui.chat/guides/introduction/authentication/) for how
    each token is obtained and when to use it.


    Need help or have questions not covered here? Reach out to
    support@talqui.com.
  license:
    name: ISC
    url: https://opensource.org/license/isc-license-txt
  title: Talqui - Services API
  version: 0.65.0
servers:
  - description: Production
    url: https://services-api.talqui.chat
security: []
tags:
  - name: Tenants
  - name: Settings
  - name: Analytics
  - name: Campaigns
  - name: Campaigns models
  - name: Contacts
  - name: Handoff links
  - name: Inboxes
  - name: Messages
  - name: Notifications
  - name: Sessions
  - name: Operators
  - name: Plugins
  - name: Setup
  - name: Uploads
paths:
  /v1/plugins/public:
    get:
      tags:
        - Plugins
      summary: List public plugins
      description: |-
        Public, unauthenticated listing of the visible plugin catalog. Only
        non-sensitive fields are returned — credentials, tokens, and other
        internal configuration are never included.
      operationId: ListPublicPluginsController
      parameters:
        - in: query
          name: page
          required: false
          schema:
            default: 1
            description: Page number, starting at 1.
            maximum: 1000
            minimum: 1
            type: integer
        - in: query
          name: perPage
          required: false
          schema:
            default: 200
            description: Maximum number of results per page.
            maximum: 500
            minimum: 1
            type: integer
        - in: query
          name: category
          required: false
          schema:
            description: Filters results to plugins in this category.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  hasMore:
                    description: Whether more results are available on a subsequent page.
                    type: boolean
                  plugins:
                    description: Visible plugins matching the request.
                    items:
                      additionalProperties: false
                      properties:
                        adapter:
                          description: >-
                            Identifies which integration this presentation
                            connects to, or null when it has a single
                            presentation.
                          nullable: true
                          type: string
                        pluginAvailable:
                          description: Whether this plugin is currently offered.
                          type: boolean
                        pluginCategory:
                          description: Category this plugin belongs to.
                          nullable: true
                          type: string
                        pluginColor:
                          description: Brand color, if curated.
                          nullable: true
                          type: string
                        pluginContact:
                          default: null
                          description: Link to contact the plugin provider, if any.
                          nullable: true
                          type: string
                        pluginDescription:
                          description: Markdown body describing the plugin.
                          type: string
                        pluginHelp:
                          default: null
                          description: Link to help/documentation for this plugin, if any.
                          nullable: true
                          type: string
                        pluginID:
                          description: >-
                            Identifier shared by every presentation of this
                            plugin.
                          type: string
                        pluginIcon:
                          description: Icon URL.
                          nullable: true
                          type: string
                        pluginMarketing:
                          additionalProperties: false
                          description: >-
                            Multi-locale copy for presenting this plugin on
                            public-facing surfaces.
                          properties:
                            en:
                              additionalProperties: false
                              nullable: true
                              properties:
                                heroDescription:
                                  default: null
                                  description: Supporting copy paired with the headline.
                                  nullable: true
                                  type: string
                                heroTitle:
                                  default: null
                                  description: >-
                                    Main headline used when presenting this
                                    plugin on its own page.
                                  nullable: true
                                  type: string
                                menuDescription:
                                  default: null
                                  description: >-
                                    Short blurb for compact listing surfaces.
                                    May be null; consumers should fall back to
                                    heroDescription.
                                  nullable: true
                                  type: string
                                seoDescription:
                                  default: null
                                  description: >-
                                    Page summary used for search engine
                                    indexing.
                                  nullable: true
                                  type: string
                                seoTitle:
                                  default: null
                                  description: Page title used for search engine indexing.
                                  nullable: true
                                  type: string
                              required:
                                - heroTitle
                                - heroDescription
                                - seoTitle
                                - seoDescription
                                - menuDescription
                              type: object
                            es:
                              additionalProperties: false
                              nullable: true
                              properties:
                                heroDescription:
                                  default: null
                                  description: Supporting copy paired with the headline.
                                  nullable: true
                                  type: string
                                heroTitle:
                                  default: null
                                  description: >-
                                    Main headline used when presenting this
                                    plugin on its own page.
                                  nullable: true
                                  type: string
                                menuDescription:
                                  default: null
                                  description: >-
                                    Short blurb for compact listing surfaces.
                                    May be null; consumers should fall back to
                                    heroDescription.
                                  nullable: true
                                  type: string
                                seoDescription:
                                  default: null
                                  description: >-
                                    Page summary used for search engine
                                    indexing.
                                  nullable: true
                                  type: string
                                seoTitle:
                                  default: null
                                  description: Page title used for search engine indexing.
                                  nullable: true
                                  type: string
                              required:
                                - heroTitle
                                - heroDescription
                                - seoTitle
                                - seoDescription
                                - menuDescription
                              type: object
                            pt:
                              additionalProperties: false
                              nullable: true
                              properties:
                                heroDescription:
                                  default: null
                                  description: Supporting copy paired with the headline.
                                  nullable: true
                                  type: string
                                heroTitle:
                                  default: null
                                  description: >-
                                    Main headline used when presenting this
                                    plugin on its own page.
                                  nullable: true
                                  type: string
                                menuDescription:
                                  default: null
                                  description: >-
                                    Short blurb for compact listing surfaces.
                                    May be null; consumers should fall back to
                                    heroDescription.
                                  nullable: true
                                  type: string
                                seoDescription:
                                  default: null
                                  description: >-
                                    Page summary used for search engine
                                    indexing.
                                  nullable: true
                                  type: string
                                seoTitle:
                                  default: null
                                  description: Page title used for search engine indexing.
                                  nullable: true
                                  type: string
                              required:
                                - heroTitle
                                - heroDescription
                                - seoTitle
                                - seoDescription
                                - menuDescription
                              type: object
                          required:
                            - pt
                            - en
                            - es
                          type: object
                        pluginName:
                          description: Display name of the plugin.
                          type: string
                        pluginOrder:
                          description: >-
                            Relative order used to sort this plugin against
                            others. Lower sorts first.
                          type: number
                        pluginOrderPublic:
                          description: >-
                            Ranking used to select a highlighted subset of
                            plugins (e.g. a top-N list). Null means this plugin
                            is not part of that ranking.
                          nullable: true
                          type: number
                        pluginPrivacy:
                          default: null
                          description: Link to the plugin privacy policy, if any.
                          nullable: true
                          type: string
                        pluginSlug:
                          description: >-
                            Unique, public identifier for this plugin, safe to
                            use in URLs.
                          nullable: true
                          type: string
                        pluginSummary:
                          description: Short, one-line summary.
                          type: string
                        pluginURN:
                          description: >-
                            Internal identifier for this plugin. Use pluginSlug
                            for public references.
                          nullable: true
                          type: string
                        pluginVisible:
                          description: >-
                            Whether this plugin is currently visible in the
                            catalog.
                          type: boolean
                        pluginWebsite:
                          default: null
                          description: Link to the plugin website, if any.
                          nullable: true
                          type: string
                        presentationKey:
                          description: >-
                            Identifies which presentation of the plugin this
                            entry is, or null when it has a single presentation.
                          nullable: true
                          type: string
                      required:
                        - pluginID
                        - presentationKey
                        - adapter
                        - pluginURN
                        - pluginAvailable
                        - pluginVisible
                        - pluginSlug
                        - pluginName
                        - pluginIcon
                        - pluginSummary
                        - pluginDescription
                        - pluginCategory
                        - pluginOrder
                        - pluginOrderPublic
                        - pluginColor
                        - pluginMarketing
                        - pluginWebsite
                        - pluginContact
                        - pluginPrivacy
                        - pluginHelp
                      type: object
                    type: array
                required:
                  - plugins
                  - hasMore
                type: object
          description: Response for status 200.
        '400':
          content:
            application/json:
              schema:
                properties:
                  errors:
                    items:
                      $ref: '#/components/schemas/RequestValidationError'
                    maxItems: 1
                    minItems: 1
                    type: array
                required:
                  - errors
                type: object
          description: >-
            RequestValidationError (error_code 1002): query params fail schema
            validation.
        '500':
          content:
            application/json:
              schema:
                properties:
                  errors:
                    items:
                      $ref: '#/components/schemas/UnknownError'
                    maxItems: 1
                    minItems: 1
                    type: array
                required:
                  - errors
                type: object
          description: >-
            UnknownError (error_code 5999): Unexpected internal error not
            otherwise documented for this endpoint.
components:
  schemas:
    RequestValidationError:
      additionalProperties: false
      properties:
        error:
          enum:
            - RequestValidationError
          type: string
        error_code:
          enum:
            - 1002
          type: number
        fields:
          items:
            additionalProperties: false
            properties:
              allowed:
                type: string
              field:
                type: string
              received:
                type: string
            required:
              - field
              - received
              - allowed
            type: object
          type: array
        message:
          example: Invalid request data.
          type: string
        statusCode:
          enum:
            - 400
          type: number
      required:
        - statusCode
        - error
        - error_code
        - message
        - fields
      type: object
    UnknownError:
      additionalProperties: false
      properties:
        error:
          enum:
            - UnknownError
          type: string
        error_code:
          enum:
            - 5999
          type: number
        message:
          example: For some unknown reason your request has not succeeded.
          type: string
        statusCode:
          enum:
            - 500
          type: number
      required:
        - statusCode
        - error
        - error_code
        - message
      type: object

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.