---
title: "Atualizar um assistente da etapa"
method: PUT
path: "/api/management/steps/{step}/assistants/{assistant}"
tags: ["step-assistants", "Assistentes"]
---

# Atualizar um assistente da etapa

`PUT /api/management/steps/{step}/assistants/{assistant}`

Substitui a configuração do assistente. O corpo é o mesmo da criação e não aceita atualização parcial: `name`, `funnel_step_id`, `ai_agent_id`, `prompt` e `execute_on` precisam vir a cada requisição, e ao menos um destino de resultado continua obrigatório.

Enviar `active: false` tira o assistente de operação sem apagar nada: a configuração e o histórico de execuções permanecem, mas ele deixa de disparar.

## Request body

- object
  - `active` number
  - `ai_agent_id` string
  - `execute_on` string
  - `failure_funnel_step_id` string
  - `funnel_step_id` number
  - `manual_execution_enabled` number
  - `name` string
  - `prompt` string
  - `result_as_dynamic_form` object
    - `edge_id` number
    - `form_id` number
    - `funnel_step_id` string
    - `id` string
    - `loose_form_id` string
    - `pivot_class` string
    - `project_funnel_id` string
    - `project_id` string
  - `result_as_media` number

## Response `200`

Sucesso

- object
  - `response` boolean
  - `assistant` object
    - `id` string
    - `name` string
    - `active` boolean
    - `funnel_step_id` integer
    - `ai_agent_id` string
    - `prompt` string
    - `execute_on` string
    - `manual_execution_enabled` boolean
    - `result_as_media` boolean
    - `result_as_dynamic_form` unknown
    - `failure_funnel_step_id` integer
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `deleted_at` unknown

---

[API](https://skmtc.net/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.net/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/063de6e2e93c/schema)