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

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# Suggest new tests

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns up to 5 test ideas that the app's existing tests don't cover yet. Nothing is saved. Add the ones you want with [Create test](/api-reference/create-test), then call [Save test generation checkpoint](/api-reference/save-test-generation-checkpoint).

If the app changed since the last checkpoint, the ideas focus on what changed. Otherwise, or when the app has no checkpoint yet, they cover gaps across the whole app.

This makes AI calls and costs credits for the ideas it returns. It runs while you wait, usually for 30 seconds to a minute and sometimes longer. The call is refused when the workspace is out of credits, or when the app has more than 245 tests.

This is limited to 20 requests per minute per caller for each app. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app. Read-only keys and workspace API keys are refused.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json post /api/apps/{app_id}/testing-agent/flows/suggest-new-tests
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/apps/{app_id}/testing-agent/flows/suggest-new-tests:
    post:
      summary: Suggest new tests
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns up to 5 test ideas that the app's existing tests don't cover
        yet. Nothing is saved. Add the ones you want with [Create
        test](/api-reference/create-test), then call [Save test generation
        checkpoint](/api-reference/save-test-generation-checkpoint).


        If the app changed since the last checkpoint, the ideas focus on what
        changed. Otherwise, or when the app has no checkpoint yet, they cover
        gaps across the whole app.


        This makes AI calls and costs credits for the ideas it returns. It runs
        while you wait, usually for 30 seconds to a minute and sometimes longer.
        The call is refused when the workspace is out of credits, or when the
        app has more than 245 tests.


        This is limited to 20 requests per minute per caller for each app. Some
        workspaces have a different limit.


        <Note>This endpoint accepts a personal API key belonging to a user with
        editor access to the app. Read-only keys and workspace API keys are
        refused.</Note>


        <Warning>The response includes fields beyond the ones documented here.
        Don't rely on undocumented response fields, as they can change at any
        time.</Warning>
      operationId: >-
        suggest_new_tests_api_apps__app_id__testing_agent_flows_suggest_new_tests_post
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app.
            title: App Id
          description: ID of the app.
          example: 6820f3a4e7b91d003c45a1f2
      responses:
        '200':
          description: The suggested tests.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TestSuggestions'
        '400':
          description: The app has more than 245 tests, or the workspace is out of credits.
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You don't have editor access to this app, the app is blocked, or
            your API key is read-only or a workspace API key.
        '404':
          description: App not found.
        '409':
          description: Your workspace requires an unlocked SSO session.
        '429':
          description: Rate limit exceeded.
components:
  schemas:
    TestSuggestions:
      properties:
        flows:
          items:
            $ref: '#/components/schemas/TestSuggestion'
          type: array
          title: Flows
          description: Up to 5 suggested tests. None of them is saved.
          example:
            - goal: >-
                Open the orders page, filter by Shipped, and check that only
                shipped orders are listed.
              name: Filter orders by status
              role: admin
      type: object
      required:
        - flows
      title: TestSuggestions
      description: Tests Base44 suggests for the app.
    TestSuggestion:
      properties:
        name:
          type: string
          title: Name
          description: Short name for the test.
          example: Filter orders by status
        goal:
          type: string
          title: Goal
          description: What the testing agent would try to do, in plain language.
          example: >-
            Open the orders page, filter by Shipped, and check that only shipped
            orders are listed.
        role:
          anyOf:
            - type: string
            - type: 'null'
          title: Role
          description: Role the test would run as, or `null` for a regular user.
          example: admin
      type: object
      required:
        - name
        - goal
        - role
      title: TestSuggestion
      description: A test Base44 suggests. It isn't saved.
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````

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