---
title: "Suggest new tests"
method: POST
path: "/api/apps/{app_id}/testing-agent/flows/suggest-new-tests"
---

# Suggest new tests

`POST /api/apps/{app_id}/testing-agent/flows/suggest-new-tests`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/testing-agent/flows/suggest-new-tests`
- Auth: HTTP bearer

<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>

## Path parameters

- `app_id` string, required: ID of the app.

## Response `200`

The suggested tests.

- TestSuggestions: Tests Base44 suggests for the app.
  - `flows` TestSuggestion[], required: Up to 5 suggested tests. None of them is saved.
    - `name` string, required: Short name for the test.
    - `goal` string, required: What the testing agent would try to do, in plain language.
    - `role` string, nullable, required: Role the test would run as, or `null` for a regular user.

## Other responses

- `400`: The app has more than 245 tests, or the workspace is out of credits.
- `401`: Missing or invalid credentials.
- `403`: 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`: App not found.
- `409`: Your workspace requires an unlocked SSO session.
- `429`: Rate limit exceeded.

## Changes

- **2026-10-11** `80287813ab84`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-06** `71aacefb68bc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/base44/apis/base44-app-management-api/changes/api/apps/:app_id/testing-agent/flows/suggest-new-tests/post.md)

---

[API](https://skmtc.dev/base44/apis/base44-app-management-api.md) - [All operations](https://skmtc.dev/base44/apis/base44-app-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/base44/apis/base44-app-management-api/revisions/c534f09cf314?raw)