---
title: "PUT /flows/{flowId}/write/status"
method: PUT
path: "/flows/{flowId}/write/status"
tags: ["flow"]
---

# PUT /flows/{flowId}/write/status

`PUT /flows/{flowId}/write/status`

## Request

- Base URL: `https://headless.dataddo.com/customer-api/v1`
- URL: `https://headless.dataddo.com/customer-api/v1/flows/{flowId}/write/status`
- Auth: none declared

Updates the write action status

## Path parameters

- `flowId` string, required

## Request body

- PutWriteActionStatusInput
  - `status` 'live' | 'broken' | 'retrying' | 'running' | 'inactive' | 'cancelling' | 'cancelled'

## Response `200`

Updates the write action status

- WriteActionDocument
  - `type` string
  - `object_id` string
  - `object_type` string
  - `status` 'live' | 'broken' | 'retrying' | 'running' | 'inactive' | 'cancelling' | 'cancelled'
  - `status_detail` string
  - `last_execution` integer, nullable: Last execution timestamp
  - `next_execution` integer, nullable: Next execution timestamp. Makes sense only for actions with schedule, otherwise it is null. It is computed and updated based on the schedule change or when action is executed.
  - `error_count` integer: Error iteration count
  - `is_being_processed` boolean: Is the action currently being processed?
  - `on_error_retry_timeout` integer: After how many seconds the action should be retried after failure. the value 0 means run retry just after. Example: set to 60*60*2 to retry action not earlier than 2hrs after failure
  - `schedule` object, nullable: Action Schedule settings
  - `created_at` integer
  - `updated_at` integer
  - `duration` string, nullable: Duration
  - `write_mode` 'insert' | 'insert_ignore' | 'truncate_insert' | 'upsert' | 'update' | 'update_ignore' | 'delete' | 'cdc'
  - `unique_columns` string[]: Array of strings.
  - `setup_instructions` string

---

[API](https://skmtc.dev/dataddo/apis/dataddo-headless-beta-api.md) · [All operations](https://skmtc.dev/dataddo/apis/dataddo-headless-beta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dataddo/apis/dataddo-headless-beta-api/revisions/dcfa2345bd10?raw)