> ## 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.
# Update test
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Changes a test's name, goal or role. Send only the fields you want to change. Send `role` as `null` to clear it, so Base44 picks a role from the test's name or goal again.
Each edit raises the test's `revision` by 1. You can't edit a test while it has a run going, so [cancel the run](/api-reference/cancel-test-run) or wait for it to end first.
This is limited to 300 requests per minute per caller for each app. Some workspaces have a different limit.
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.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json patch /api/apps/{app_id}/testing-agent/flows/{flow_id}
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/{flow_id}:
patch:
summary: Update test
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
Changes a test's name, goal or role. Send only the fields you want to
change. Send `role` as `null` to clear it, so Base44 picks a role from
the test's name or goal again.
Each edit raises the test's `revision` by 1. You can't edit a test while
it has a run going, so [cancel the run](/api-reference/cancel-test-run)
or wait for it to end first.
This is limited to 300 requests per minute per caller for each app. Some
workspaces have a different limit.
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.
operationId: update_flow_api_apps__app_id__testing_agent_flows__flow_id__patch
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
- name: flow_id
in: path
required: true
schema:
type: string
description: ID of the test to update.
title: Flow Id
description: ID of the test to update.
example: 68a1c2e4f0b3d9001a7e5c21
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateFlowRequest'
responses:
'200':
description: The updated test.
content:
application/json:
schema:
$ref: '#/components/schemas/FlowResponse'
'400':
description: You sent no fields, or `name` or `goal` is only whitespace.
'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 or test not found.
'409':
description: >-
The test has a run going, or your workspace requires an unlocked SSO
session.
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
'429':
description: Rate limit exceeded.
components:
schemas:
UpdateFlowRequest:
properties:
name:
anyOf:
- type: string
maxLength: 100
minLength: 1
- type: 'null'
title: Name
description: New name for the test.
example: Create a project
goal:
anyOf:
- type: string
maxLength: 500
minLength: 1
- type: 'null'
title: Goal
description: New goal for the test, in plain language.
example: >-
Sign up, create a project called Launch, and check that it appears
on the dashboard.
role:
anyOf:
- type: string
maxLength: 100
- type: 'null'
title: Role
description: >-
Role to run the test as. Send `null` to clear it, so Base44 picks
one from the name or goal again.
example: admin
type: object
title: UpdateFlowRequest
FlowResponse:
properties:
id:
type: string
title: Id
description: ID of the test.
example: 68a1c2e4f0b3d9001a7e5c21
app_id:
type: string
title: App Id
description: ID of the app the test belongs to.
example: 6820f3a4e7b91d003c45a1f2
name:
type: string
title: Name
description: Short name of the test.
example: Create a project
goal:
type: string
title: Goal
description: What the testing agent tries to do, in plain language.
example: >-
Sign up, create a project called Launch, and check that it appears
on the dashboard.
role:
anyOf:
- type: string
- type: 'null'
title: Role
description: >-
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.
example: admin
source:
type: string
title: Source
description: >-
`manual` for a test you created, `app_context` for one Base44
generated from the app.
example: manual
revision:
type: integer
title: Revision
description: Starts at 1 and goes up each time the test is edited.
example: 1
created_date:
type: string
title: Created Date
description: When the test was created, as an ISO 8601 UTC timestamp.
example: '2026-09-28T10:15:00+00:00'
updated_date:
type: string
title: Updated Date
description: When the test last changed, as an ISO 8601 UTC timestamp.
example: '2026-09-28T10:15:00+00:00'
type: object
required:
- id
- app_id
- name
- goal
- source
- revision
- created_date
- updated_date
title: FlowResponse
description: 'A test: a goal the testing agent tries to accomplish in a browser.'
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:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: 'Personal access token, sent as `Authorization: Bearer `.'
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.