---
title: "PATCH /v1/worker/runs/{runId}"
method: PATCH
path: "/v1/worker/runs/{runId}"
tags: ["Runs", "The runner"]
---

# PATCH /v1/worker/runs/{runId}

`PATCH /v1/worker/runs/{runId}`

## Request

- Base URL: `https://api.taada.dev`
- URL: `https://api.taada.dev/v1/worker/runs/{runId}`
- Auth: HTTP bearer

## Path parameters

- `runId` string, uuid, required

## Request body

- object
  - `status` 'passed' | 'blocked' | 'errored', required
  - `flows_passed` integer, required
  - `flows_total` integer, required
  - `results` object[]
    - `flowId` string, uuid, required
    - `name` string, required
    - `passed` boolean, required
    - `steps` object[], required
      - `id` string, required
      - `action` string, required
      - `expect` string
      - `ok` boolean, required
      - `note` string
      - `detail` string
      - `notRun` boolean
      - `route` string
      - `judged` object
        - `question` string, required
        - `answers` object[], required
          - `verdict` 'yes' | 'no', required
          - `why` string, required
        - `outcome` 'yes' | 'no' | 'differed', required
        - `model` string, required
      - `role` string
      - `replayed` 'recording' | 'old_way'
      - `replayed_why` string
      - `appeared` string[]
      - `nearMiss` object
        - `stepId` string, required
        - `wanted` string, required
        - `closest` string[], required
        - `role` string
        - `landed` string
      - `requiredEmpty` object[]
        - `label` string, required
        - `trigger` string, required
        - `options` string[], required
        - `kind` 'select' | 'combobox', required
      - `filled` object[]
        - `label` string, required
        - `kind` string, required
        - `value` string, required
      - `form` object
        - `pressed` string, required
        - `stayed` boolean, required
        - `went` boolean
        - `emptyBefore` string[]
        - `title` string, required
        - `fields` object[], required
          - `label` string, required
          - `kind` string, required
          - `required` boolean, required
          - `evidence` string[], required
          - `filled` boolean, required
          - `invalid` boolean, required
          - `error` string
        - `errors` string[], required
    - `skipped` boolean
    - `skipped_because` string, uuid, nullable
    - `observed` object
      - `watchedHost` string, nullable, required
      - `serverErrors` object, required
        - `total` integer, required
        - `errors` object[], required
          - `method` string, required
          - `path` string, required
          - `status` integer, required
          - `stepId` string, nullable, required
          - `stepIndex` integer, nullable, required
          - `atS` number, nullable, required
      - `slowest` object[], required
        - `method` string, required
        - `path` string, required
        - `waitMs` number, required
        - `stepId` string, nullable, required
        - `stepIndex` integer, nullable, required
        - `atS` number, nullable, required
      - `console` object
        - `total` integer, required
        - `errors` object[], required
          - `kind` 'error' | 'exception', required
          - `text` string, required
          - `times` integer, required
          - `stepId` string, nullable, required
          - `stepIndex` integer, nullable, required
          - `atS` number, nullable, required
          - `path` string
      - `brokenLinks` object
        - `total` integer, required
        - `links` object[], required
          - `method` string, required
          - `path` string, required
          - `status` integer, required
          - `times` integer, required
          - `stepId` string, nullable, required
          - `stepIndex` integer, nullable, required
          - `atS` number, nullable, required
    - `routes` string[]
    - `language` object
      - `written` string, required
      - `shown` string, required
      - `outcome` 'switched' | 'switch_failed' | 'no_switch' | 'seen_at_failure', required
      - `via` string
  - `video_id` string, uuid, nullable
  - `error` string, nullable
  - `error_code` 'session_expired' | 'no_runner' | 'worker_died' | 'run_timeout' | 'flowless_claim' | 'recording_failed' | 'app_unreachable' | 'app_closed' | 'needs_person' | 'judgment_unavailable' | 'nothing_checked' | 'writer_cannot' | 'no_sign_in_here' | 'preview_sign_in_refused' | 'preview_needs_password', nullable
  - `judgments` object
    - `judgments` integer, required
    - `calls` integer, required
    - `inputTokens` number, required
    - `outputTokens` number, required
  - `writing` object
    - `usd` number, required
    - `turns` integer, required
    - `minutes` number, required
    - `model` string, required
    - `tries` integer
    - `tried` string[]
    - `reuse` object
      - `offered` integer, required
      - `chosen` string
      - `steps` integer
    - `proven` object
      - `environmentId` string, required
      - `steps` object[], required
        - `action` string, required
        - `expect` string
        - `selector` string
      - `from` object
        - `testId` string, required
        - `name` string, required
        - `steps` integer, required
  - `points` object[]
    - `n` integer, required
    - `title` string, required
    - `sentence` string, required
    - `expect` string, nullable, required
    - `why` string
    - `state` 'passed' | 'blocked' | 'not_reached' | 'not_written', required
  - `sign_in_offered` string[]
  - `way_in_trail` object[]
    - `way` string, required
    - `outcome` string, required
    - `reason` string
  - `handed_back` boolean
  - `accounts_created` object[]
    - `role` string, required
    - `email` string, email, required
    - `password` string, required
    - `name` string
  - `learning` true
  - `no_recording` true
  - `screens` object[]
    - `route` string, required
    - `url` string, required
    - `title` string, required
    - `headings` string[], required
    - `lines` string[], required
    - `fields` unknown[], required
      - unknown
    - `controls` unknown[], required
      - unknown
    - `collection` boolean, required
  - `journey_flow` string
  - `noticed` object[]
    - `kind` 'error_screen' | 'server_error' | 'page_error', required
    - `route` string, required
    - `sentence` string, required

## Response `200`

Default Response

---

[API](https://skmtc.dev/taada/apis/tada.md) · [All operations](https://skmtc.dev/taada/apis/tada/llms.txt) · [OpenAPI document](https://skmtc.dev/taada/apis/tada/revisions/9079c5c8a580?raw)