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

# Update automation

> Rename an automation, turn it on or off, or repair it with a corrected definition

This endpoint has two modes:

* **Rename / toggle** — pass `name` and/or `enabled` to rename the automation or turn it on/off.
* **Repair** — pass a corrected `flow` definition and the automation is rebuilt in place, re-tested with a **real run**, and re-activated only when the test passes. Use this after diagnosing a failure with [Get automation](https://docs.lacy.ai/api-reference/automations/get-automation.md) and [List automation runs](https://docs.lacy.ai/api-reference/automations/list-automation-runs.md).

To undo a repair that made things worse, roll back to the previous published version with [Restore previous version](https://docs.lacy.ai/api-reference/automations/restore-automation.md).

> [!WARNING]
>
> A repair definition **replaces the whole automation** — it is never merged. Read the current definition first and resend the complete chain, including every step that must stay; steps you leave out are deleted. The repair test run executes the automation for real, so `confirm_side_effects: true` is required again when the corrected definition contains sending steps.

### Path Parameters

**id** `string` *required*

The ID of the automation (from [List automations](https://docs.lacy.ai/api-reference/automations/list-automations.md))

### Request body

**name** `string`

A new name for the automation (max 255 characters). In repair mode, the current name is kept when omitted.

**enabled** `boolean`

`true` to turn the automation on, `false` to turn it off

**flow** `object`

Repair mode: the corrected full definition, in the same format as [Create automation](https://docs.lacy.ai/api-reference/automations/create-automation.md) (`{"trigger": {...}, "steps": [...]}`). Max 1 MB.

**sample** `object`

Sample payload for the repair test run (for assistant events, the canonical sample is used when omitted). Max 256 KB.

**assistant\_id** `integer`

For repairs of assistant-event automations: the assistant to (re)attach to. Usually already carried inside the definition's trigger.

**confirm\_side\_effects** `boolean`

Required (`true`) when the corrected definition contains steps that send messages or emails, start calls, or make non-GET HTTP requests

A request with none of `name`, `enabled` or `flow` returns a `422` asking for at least one of them.

### Response — rename / toggle

**data** `object`

The refreshed automation summary

**data properties**

**id** `string`

The automation ID

**name** `string`

The automation's (possibly new) name

**status** `string`

`enabled` or `disabled`

**updated** `boolean`

Whether every requested change was applied

### Response — repair

The same envelope as [Create automation](https://docs.lacy.ai/api-reference/automations/create-automation.md) (`automation_id`, `status`, `test`, `response`, `binding`), without `webhook_url` — a repaired automation keeps its original webhook URL. Returned with HTTP `200`; `status` is `active`, `active_untested` or `test_failed`. A repair whose test fails leaves the automation disabled; a repair rejected before the test run (e.g. `no_steps`) leaves the existing automation untouched.

A missing automation — or one that does not belong to your account — returns a `404` with `{"message": "Automation not found"}`.

```json 200 Response (rename + disable) theme={null}
{
  "data": {
    "id": "f4EaLhOW2zoEsXXSOJP2r",
    "name": "Order lookup v2",
    "status": "disabled",
    "updated": true
  }
}
```

```json 200 Response (repair, test passed) theme={null}
{
  "automation_id": "f4EaLhOW2zoEsXXSOJP2r",
  "status": "active",
  "test": {
    "run_status": "SUCCEEDED",
    "steps": []
  },
  "response": null,
  "binding": null
}
```

```json 404 Response theme={null}
{
  "message": "Automation not found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.