Authorizations
- Authorization string required header
Workspace REST API token prefixed with bp_
Request Body
application/json- appId string required
Bubble app ID for the workspace project this request targets.
- name string required
Name of the test or reusable component.
- description string | null
Optional description.
- isComponent boolean
Whether the definition should be created or updated as a reusable component.
- liveTestUserId string | null
Optional test user assigned to live runs.
- testVersionTestUserId string | null
Optional test user assigned to test-version runs.
- viewportPreset string enum | null
Optional viewport preset for runnable tests.
- steps[] oneOf required array
Ordered steps that define the test or reusable component.
+ - Show Child Attributes
- oneOf options 2 variants oneOf
Exactly one option applies.
+ - Show Child Attributes
- option 1 object
+ - Show Child Attributes
- kind string required
Marks this entry as a direct executable step.
- instruction string required
Instruction the agent should carry out.
- details string | null
Optional extra detail to provide more context for the instruction.
- onFailure string enum required enum
Whether the run should stop or continue if this step fails. Allowed values: stop, continue.
- option 2 object
+ - Show Child Attributes
- kind string required
Marks this entry as a reusable component reference.
- componentId string required
Project test component identifier to expand.
- onFailure string enum enum
Whether the run should stop or continue if the component fails. Allowed values: stop, continue.
Response
application/json- testId string
Opaque identifier for the project test definition.