---
title: "Executar um assistente manualmente"
method: POST
path: "/api/management/step-assistants/{step_assistant}/execute-manually"
tags: ["step-assistants", "Execução"]
---

# Executar um assistente manualmente

`POST /api/management/step-assistants/{step_assistant}/execute-manually`

Dispara um assistente sob demanda para um projeto, sem depender da movimentação de etapa.

Só vale para assistentes com gatilho `manual` ou com a execução manual habilitada; os demais respondem como não encontrado. O projeto precisa estar na etapa do assistente e ser visível para quem faz a chamada.

A execução é assíncrona: a resposta apenas confirma o enfileiramento, e o resultado aparece no projeto e no histórico de execuções alguns instantes depois. Um assistente inativo não executa nada e ainda assim responde com sucesso.

## Request body

- object — Projeto alvo da execução manual.
  - `project_id` string, uuid, required — ID (UUID) do projeto sobre o qual o assistente será executado. Obrigatório. O projeto precisa estar na etapa do assistente.

## Response `200`

Enfileirado

- object — Confirmação de que a operação foi concluída.
  - `response` boolean, required — Sempre true quando a operação é concluída.

## Other responses

- `404` — Assistente não aceita execução manual

## Changes

- **2026-08-24** `3c590152d5b5` — 3 breaking, 4 info
  - the request property `project_id` became not nullable
  - the request property `project_id` became required
  - the `project_id` request property type changed from no type to `string`, and format from no format to `uuid`
  - the response property `error` became required for the status `404`
  - …3 more
- **2026-08-19** `063de6e2e93c` — 2 info
  - api tag `Execução` added
  - api tag `execute-manually` removed
- **2026-08-19** `69f9300dc045` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `404`
- **2026-08-19** `3227b85304ca` — 1 info
  - added optional request body

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/step-assistants/:step_assistant/execute-manually/post.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-service-production.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/85cb24130071/schema)