---
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
  - `project_id` unknown

## Response `200`

Enfileirado

- object
  - `response` boolean

## Other responses

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

---

[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)