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

# List Chatbots

> List chatbots the API key owner can access in the selected tenant.



## OpenAPI

````yaml get /external/chatbots
openapi: 3.1.0
info:
  title: Shieldbase External API
  description: Public API for Shieldbase AI integration
  version: 1.0.0
servers:
  - url: https://api.shieldbase.ai
    description: Production
  - url: http://localhost:8000
    description: Development
security:
  - ClientID: []
    APIKey: []
    Secret: []
paths:
  /external/chatbots:
    get:
      tags:
        - Chatbots
      summary: List Chatbots
      description: List chatbots the API key owner can access in the selected tenant.
      parameters:
        - $ref: '#/components/parameters/TenantID'
        - name: page
          in: query
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: page_size
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
        - name: search
          in: query
          description: Search by name or title
          schema:
            type: string
      responses:
        '200':
          description: Accessible chatbots
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Chatbot'
                  pagination:
                    type: object
                    properties:
                      current_page:
                        type: integer
                      page_size:
                        type: integer
        '403':
          description: Invalid API credentials
components:
  parameters:
    TenantID:
      name: X-Tenant-ID
      in: header
      required: false
      description: >-
        Optional tenant selector for multitenant accounts. The API key owner
        must have access to the selected tenant.
      schema:
        type: string
  schemas:
    Chatbot:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        title:
          type: string
        type:
          type: string
          enum:
            - workflow
            - standard
          description: '`workflow` for flow chatbots, `standard` for prompt chatbots'
        workflow_id:
          type:
            - string
            - 'null'
        public:
          type: boolean
        shared:
          type: boolean
        owner_name:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
  securitySchemes:
    ClientID:
      type: apiKey
      in: header
      name: X-Client-ID
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
    Secret:
      type: apiKey
      in: header
      name: X-Secret

````

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