---
title: "Update an automation"
description: "Rename, pause or change an automation. `filter` and `actions` each replace the whole of themselves. A change applies to mentions scored from then on."
canonical: https://docs.mentio.dev/api/automations/update-automation
markdown: https://docs.mentio.dev/api/automations/update-automation.mdx
---

# Update an automation

`PATCH /v1/automations/{id}`

Rename, pause or change an automation. `filter` and `actions` each replace the whole of themselves. A change applies to mentions scored from then on.

## Parameters

- `id` (path, required): Automation id (atm_...).

## Body

- `name`: Automation name, unique in the workspace.
- `enabled`: false stops it; true runs it again on new mentions.
- `filter`: Replaces the whole filter.
- `actions`: Replaces every action.

## Responses

- 200: The updated automation
- 400: Invalid request, or invalid_assignee: the assignee is not a workspace member
- 401: Missing or invalid API key
- 404: No such automation in this workspace
- 409: duplicate_automation: the name is taken

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx