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

# Get AIs

> You can obtain all AI types you create through this interface.

- If user_ids is provided: Returns grouped format [{"user_id": "123", "bots": [bot_id1, bot_id2...]}, ...]
- If user_ids is not provided: Returns paginated list of current user's robots



## OpenAPI

````yaml https://api.gbase.ai/openapi-redoc.json get /v1/ais
openapi: 3.1.0
info:
  title: GBase
  description: >
    # Introduce

    This API document can help you understand GBase more deeply. 

    You can train your own AI directly through the interface of this document.



    ##  Authentication


    Home page: [https://gbase.ai](https://gbase.ai)


    Huggingface:
    [https://huggingface.co/gptbase](https://huggingface.co/gptbase)


    The GBase API uses API keys for authentication. Visit your API Keys page to
    retrieve the API key you'll use in your requests.


    Remember that your API key is a secret! Do not share it with others or
    expose it in any client-side code (browsers, apps). 

    Production requests must be routed through your own backend server where
    your API key can be securely loaded from an environment variable or key
    management service.


    All API requests should include your API key in an Authorization HTTP header
    as follows:


    Parameter name: Authorization


    Value: Bearer [YOUR_API_KEY](https://admin.gbase.ai/keys)


    ```

    Authorization: Bearer YOUR_API_KEY

    ```


    ## Use steps

    1.Fill in your API keys.


    2.You can create an AI by using either the API interface or the
    administrative backend. Once created, the AI will generate an ID which will
    be required for the subsequent steps.


    3.Use the generated ID to call the file upload interface.


    4.After uploading the file, you can use the question interface to inquire
    about it.
  version: 0.0.1
servers:
  - url: https://api.gbase.ai
security: []
paths:
  /v1/ais:
    get:
      tags:
        - GBase AI
      summary: Get AIs
      description: >-
        You can obtain all AI types you create through this interface.


        - If user_ids is provided: Returns grouped format [{"user_id": "123",
        "bots": [bot_id1, bot_id2...]}, ...]

        - If user_ids is not provided: Returns paginated list of current user's
        robots
      operationId: get_ais_v1_ais_get
      parameters:
        - description: Search by robot name or description
          required: false
          schema:
            type: string
            title: Search
            description: Search by robot name or description
          name: search
          in: query
        - description: >-
            Company ID. If provided, returns company resources; if not, returns
            personal resources
          required: false
          schema:
            type: string
            title: Company Id
            description: >-
              Company ID. If provided, returns company resources; if not,
              returns personal resources
          name: company_id
          in: query
        - description: >-
            List of user IDs to get bots for. Returns grouped format: [{user_id,
            bots: [...]}]
          required: false
          schema:
            items:
              type: string
            type: array
            title: User Ids
            description: >-
              List of user IDs to get bots for. Returns grouped format:
              [{user_id, bots: [...]}]
          name: user_ids
          in: query
        - description: >-
            Filter by robot tag IDs. Robots must have ALL specified tags (AND
            logic).
          required: false
          schema:
            items:
              type: string
            type: array
            title: Tag Ids
            description: >-
              Filter by robot tag IDs. Robots must have ALL specified tags (AND
              logic).
          name: tag_ids
          in: query
        - required: false
          schema:
            type: integer
            minimum: 1
            title: Page
            default: 1
          name: page
          in: query
        - required: false
          schema:
            type: integer
            maximum: 1000
            minimum: 1
            title: Size
            default: 50
          name: size
          in: query
        - required: false
          schema:
            type: string
            title: Order By
          name: order_by
          in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - Auth0HTTPBearer: []
        - HTTPBearer: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````