Parar uma execução

Stop gracioso de um run em andamento: o nó atual termina, nada mais roda e o usage parcial chega no done.

Atualizado em 10 de ago. de 2026

Workflows multi-agente podem rodar por minutos. Se você já tem o que precisa — ou o usuário desistiu — pare o run com o thread_id que chegou no primeiro evento.

POSThttps://agents.hinow.ai/v1/agents/runs/{thread_id}/stopBearer hi_SUA_API_KEY

Para graciosamente a execução ativa deste thread.

Parâmetros

thread_idstring· pathobrigatório
O thread_id devolvido no primeiro evento do run.

Respostas

200Pedido aceito. `stopped: false` significa que o run já tinha terminado sozinho.

{"success": true, "thread_id": "ae732033-...", "stopped": true}

404Nenhum run ativo com esse thread_id no seu escopo.

O que acontece

1
O pedido é aceito na hora
A resposta chega em ~50 ms. O sinal segue para o runtime do workflow.
2
O passo em andamento termina
A chamada de modelo ou ferramenta em voo conclui (ela já foi iniciada — e cobrada). Nenhum passo novo começa: nem o próximo nó, nem a próxima rodada de um debate, nem o próximo votante.
3
O run encerra limpo
O stream recebe workflow_stopped e depois done com o usage parcial. A conversa e as variáveis persistidas são salvas — o thread pode continuar depois.

final do stream após um stopjson

data: {"type":"workflow_node_end","data":{"node_id":"juiz-intro","success":true}}

data: {"type":"workflow_stopped","data":{"node_id":"debate-loop","reason":"user_requested"}}

data: {"type":"done","usage":{"cost":0.00066,"input_tokens":829,"output_tokens":406,"time":54.7}}

No modo síncrono (stream: false), a resposta chega com finish_reason: "stopped" e o texto parcial do que foi produzido até ali.

Stop ≠ desconectar

Fechar a conexão SSE também aborta o run — mas aí você perde o done e o usage. O stop existe para o modo síncrono e para parar mantendo a conexão aberta até o encerramento limpo.

O tempo até o encerramento efetivo depende do passo em voo: com um provedor de modelo lento, pode levar até ~1 minuto. O que nunca acontece é um passo novo começar depois do stop.

Esta página foi útil?