> ## Documentation Index
> Fetch the complete documentation index at: https://docs.testyourappnow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recorded Flows

> List, run, inspect, delete, or schedule recorded flows.

List, run, inspect, delete, or schedule recorded flows. Dispatch the desired operation with the `action` field in the request body.

## Actions

| Action     | Description                                                         |
| ---------- | ------------------------------------------------------------------- |
| `list`     | List all saved flows for the authenticated user.                    |
| `run`      | Queue a flow replay. Returns `202` with a `runId`.                  |
| `runs`     | Retrieve past runs for a flow, including step results and analysis. |
| `delete`   | Delete a saved flow.                                                |
| `schedule` | Schedule a flow replay for later or on an interval.                 |

## Request body

<ParamField body="action" type="string" required>
  One of `list`, `run`, `runs`, `delete`, or `schedule`.
</ParamField>

<ParamField body="data" type="object">
  Payload for the selected action.

  <Expandable title="data fields">
    <ParamField body="flowId" type="string">
      Identifier of the saved flow. Required for `run`, `runs`, `delete`, and `schedule`.
    </ParamField>

    <ParamField body="when" type="string">
      Schedule mode: `at`, `every`, or `now`. Required for `schedule`.
    </ParamField>

    <ParamField body="time" type="string">
      Time expression paired with `when`. Required for `schedule`.
    </ParamField>
  </Expandable>
</ParamField>

## Responses

### `200 OK`

Returned for `list`, `runs`, `delete`, and `schedule`.

<ResponseField name="success" type="boolean" required />

<ResponseField name="message" type="string" required>
  One of `Flows loaded.`, `Flow runs loaded.`, `Flow deleted.`, or `Flow replay scheduled.`
</ResponseField>

<ResponseField name="content" type="object" required>
  Payload matching the message. For example, `flows`, `runs`, `{ ok: true }`, or `{ transactionId, scheduledId, kind }`.
</ResponseField>

### `202 Accepted`

Returned for `run` when the replay is queued.

<ResponseField name="content.runId" type="string" required />

### `503 Service Unavailable`

The replay queue could not accept the job. Retry with backoff.

<Info>
  Successful responses include the `X-Credits-Remaining` header.
</Info>