---
title: "Atualizar automação"
method: PUT
path: "/api/management/automations/{automation}"
tags: ["automations"]
---

# Atualizar automação

`PUT /api/management/automations/{automation}`

Substitui a definição da automação: componentes enviados com o ID de um existente são atualizados, os com ID temporário são criados e os que ficarem de fora são removidos. `active` é obrigatório e liga ou desliga a automação. Componentes e opções em [Gatilhos](https://docs.olie.ai/guides/automation/triggers) e [Condições](https://docs.olie.ai/guides/automation/conditions).

## Request body

- object — Definição da automação.
  - `title` string, required — Nome da automação.
  - `active` boolean, required — Liga (true) ou desliga (false) a automação.

## Response `200`

Sucesso

- object — Automação atualizada.
  - `response` boolean — Indicador de sucesso da requisição. Sempre true nas respostas bem-sucedidas.
  - `automation` object — Automação atualizada, com seus componentes.
    - `id` integer — ID da automação.
    - `title` string — Nome da automação.
    - `active` boolean — Se a automação está ligada.
    - `executions` integer, nullable — Quantas vezes a automação foi executada.
    - `components` object[] — Componentes do fluxo, ordenados por order.
      - `id` string, uuid — ID (UUID) do componente.
      - `type` 'trigger' | 'condition' | 'action' — Tipo do componente.
      - `variant` 'project_step_moved_trigger' | 'project_idle_in_step_trigger' | 'project_field_change_trigger' | 'project_tag_linked_trigger' | 'project_dynamic_form_edited_trigger' | 'project_date_reached_trigger' | 'project_execution_trigger' | 'project_content_added_trigger' | 'project_contains_tag_condition' | 'project_contains_funnel_status_condition' | 'project_in_step_condition' | 'project_filter_checker_condition' | 'project_step_put_action' | 'project_change_status_action' | 'project_content_add_action' | 'send_an_email_action' | 'update_project_funnel_status_action' | 'project_funnel_link_toggle_action' | 'project_funnel_tag_add_action' | 'project_funnel_tag_remove_action' | 'project_add_loose_form_action' | 'project_group_link_toggle_action' | 'update_form_counter_action' | 'project_save_form_history_action' | 'unlink_project_from_step_action' | 'webhook_dispatch_action' | 'create_project_action' | 'assignee_users_action' | 'update_date_field_action' | 'create_customer_action' | 'create_contact_action' | 'create_project_hierarchy_action' | 'step_assistant_execute_manually_action' | 'update_manual_goal_progress_action' | 'project_execution_control_action' — Variante do componente.
      - `parent_id` string, nullable — ID da condição à qual o componente pertence. Nulo no nível principal.
      - `conditional_case` 'when_true' | 'when_false' | 'null', nullable — Ramo da condição pai: when_true ou when_false.
      - `order` integer — Posição entre os irmãos.
      - `project_scope` object, nullable — Escopo de projetos salvo (scope, quantifier, advanced_syntax, hierarchy_levels). Nulo em gatilhos.
        - `scope` 'trigger' | 'descendants' | 'ancestors' | 'siblings' | 'siblings_including_trigger' | 'advanced_syntax' | 'filtered' — Em quais projetos o componente age.
        - `quantifier` 'all' | 'any' | 'none' — Como uma condição combina resultados de vários projetos.
        - `advanced_syntax` string — Expressão que devolve os projetos.
        - `hierarchy_levels` integer[] — Níveis da hierarquia considerados.
      - `project_scope_saved_filter_id` union — ID do filtro salvo que restringe os projetos da ação.
        - string
        - integer
      - `config` object — Opções do componente; as chaves dependem da variante.
      - `relations` object[] — Vínculos do componente.
        - `id` string, uuid — ID (UUID) do vínculo.
        - `model_type` string — Tipo do objeto vinculado.
        - `model_id` string — ID do objeto vinculado, em texto.
        - `discriminator` string, nullable — Papel do vínculo, quando a variante distingue mais de um.
      - `created_at` string, date-time — Data de criação do componente.
      - `updated_at` string, date-time — Data da última alteração do componente.
      - `deleted_at` string, date-time, nullable — Data de exclusão do componente. Nulo quando ativo.
    - `created_at` string, date-time — Data de criação da automação.
    - `updated_at` string, date-time — Data da última alteração da automação.
    - `deleted_at` string, date-time, nullable — Data de exclusão. Sempre nulo nas respostas.

## Other responses

- `404` — Não encontrada
- `422` — Validação falhou

## Changes

- **2026-09-22** `d8fb547e20a2` — 26 breaking, 43 warning, 63 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9, subschema #10, subschema #11, subschema #12, subschema #13, subschema #14, subschema #15, subschema #16, subschema #17, subschema #18, subschema #19, subschema #20, subschema #21, subschema #22, subschema #23, subschema #24, subschema #25, subschema #26, subschema #27, subschema #28, subschema #29, subschema #30, subschema #31, subschema #32, subschema #33, subschema #34, subschema #35` to the `components/items/` request property `allOf` list
  - request property `components/items/conditional_case` was restricted to a list of enum values
  - request property `components/items/relations/items/model_type` was restricted to a list of enum values
  - request property `components/items/type` was restricted to a list of enum values
  - …128 more
- **2026-09-22** `4e244f2507d6` — 4 info
  - added optional request body
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `404`
  - added the non-success response with the status `422`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/automations/:automation/put.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olie-ai/apis/olie-api/revisions/d7bda7d32f67?raw)