BAbase44

List tests

Changed on

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

Returns every test in the app, newest first. An app has at most 250 tests, so the list is never paged.

This is limited to 6000 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 access to the app, including a read-only key. Workspace API keys are not accepted.</Note>

get/api/apps/{app_id}/testing-agent/flows

Request

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

Path parameters

app_idstring required

ID of the app.

Response

The app's tests.

idstring required

ID of the test.

app_idstring required

ID of the app the test belongs to.

namestring required

Short name of the test.

goalstring required

What the testing agent tries to do, in plain language.

rolestring nullable

Role set on the test, or null when none is set. A test without one can still run as a role its name or goal names. The run's flow_role shows the role actually used.

sourcestring required

manual for a test you created, app_context for one Base44 generated from the app.

revisioninteger required

Starts at 1 and goes up each time the test is edited.

created_datestring required

When the test was created, as an ISO 8601 UTC timestamp.

updated_datestring required

When the test last changed, as an ISO 8601 UTC timestamp.

Example response

[
  {
    "id": "68a1c2e4f0b3d9001a7e5c21",
    "app_id": "6820f3a4e7b91d003c45a1f2",
    "name": "Create a project",
    "goal": "Sign up, create a project called Launch, and check that it appears on the dashboard.",
    "role": "admin",
    "source": "manual",
    "revision": 1,
    "created_date": "2026-09-28T10:15:00+00:00",
    "updated_date": "2026-09-28T10:15:00+00:00"
  }
]

Changes

  • 32455e516133Revision changes
    • info

      the security scope read_only was added to the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the security scope full_access was removed from the endpoint's security scheme PersonalAccessTokenAuth

  • 80287813ab84Revision changes
    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API