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

# POST /v1/worker/runs/{runId}/atlas

`POST /v1/worker/runs/{runId}/atlas`

## Request

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

## Path parameters

- `runId` string, uuid, required

## Request body

- object
  - `screens` object[], required
    - `route` string, required
    - `url` string, required
    - `title` string, required
    - `headings` string[], required
    - `lines` string[], required
    - `fields` object[], required
      - `label` string, required
      - `type` string, required
      - `required` boolean, required
      - `purpose` string, required
      - `on` boolean
    - `controls` object[], required
      - `label` string, required
      - `kind` string, required
      - `submits` boolean, required
      - `href` string, required
      - `role` 'tab' | 'switch' | 'radio' | 'checkbox' | 'toggle'
      - `on` boolean
      - `opens` boolean
      - `options` string[]
      - `name` string
    - `collection` boolean, required
  - `unopened` string[], required
  - `stopped` string, required
  - `signInWall` boolean, required
  - `door` object
    - `landed` object, required
      - `route` string, required
      - `kind` string, required
    - `offSite` boolean, required
    - `signIn` object, nullable, required
      - `url` string, required
      - `route` string, required
      - `how` string, required
    - `methods` string[], required
    - `sso` string[], required
    - `providers` string[]
    - `fieldKinds` string[]
    - `protection` 'hosting_lock' | 'bot_check' | 'basic_auth' | 'none'
    - `status` integer[]
    - `guard` object, nullable
      - `route` string, required
      - `status` integer[], required
    - `signUp` object, nullable, required
      - `route` string, nullable, required
      - `form` boolean, required
    - `appOrigin` string, nullable, required
    - `signedIn` object, nullable, required
      - `with` 'session', required
      - `works` boolean, nullable, required
      - `landed` string, nullable, required
      - `cookies` string[]
    - `cost` object, required
      - `loads` integer, required
      - `requests` integer, required
      - `seconds` integer, 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)