---
title: "Preview a run of this automation"
method: POST
path: "/v1/automations/{automationId}/dry-run"
tags: ["Automations"]
---

# Preview a run of this automation

`POST /v1/automations/{automationId}/dry-run`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/automations/{automationId}/dry-run`
- Auth: HTTP bearer

Same as the unsaved preview, defaulting to the automation's current spec.

## Path parameters

- `automationId` string, uuid, required

## Request body

- DryRunRequest
  - `workflow_spec` union: Spec to preview (required on the unsaved-spec route).
    - object[]
    - object
  - `input` object: Simulated trigger payload (`{{trigger.*}}`).

## Response `200`

Preview

- DryRunResponse
  - `ok` boolean, required: True when there are no warnings.
  - `error` string
  - `warnings` string[]
  - `parks` integer: How many steps park the run.
  - `budget` object
  - `steps` object[]
    - `index` integer, required
    - `name` string, nullable
    - `type` string, required
    - `known` boolean, required
    - `resolved` object, required: The step after template substitution.
    - `skipped_by` string, nullable
    - `effect` string, required
    - `on_error` object, required
      - `action` string
      - `max_attempts` integer
      - `backoff_secs` integer
    - `unresolved_templates` string[], required
    - `budget_exceeded` string, nullable

## Other responses

- `401`: Authentication required or invalid
- `404`: Resource not found

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)