Create an unstepped (agent-driven) test journey

Creates an unstepped journey — one with no scripted steps. An AI agent reads the journey name, description, and instructions, then drives the app with Playwright to carry out the flow, recording the session and filing any bugs it finds.

If the project is active, the journey is scheduled to run immediately. Use target_url to point this journey at a URL different from the project's base URL (e.g. a deep link or a different environment) — that URL is where the recording is created. Set polish to also run the project's enabled polish passes against the resulting recording.

post/api/v1/projects/{project_id}/journeys

Request

  • Base URL: https://qa.replay.io
  • URL: https://qa.replay.io/api/v1/projects/{project_id}/journeys
  • Auth: HTTP bearer

Path parameters

project_idstring required

Request body

namestring required

Short name for the journey (the flow under test).

descriptionstring

What the agent should do — the scenario to carry out in the app.

instructionsstring

Optional extra guidance / post-run checks for the agent.

target_urlstring

Optional URL to record this journey against, overriding the project's base URL. When omitted, the project's URL is used.

polishboolean

When true, the project's enabled polish passes also run against this journey's recording.

Response

Created journey

Changes

No recorded changes to this operation across all 1 revision of this API.