Cancelar execução

Cancela execução em WAITING (limpa waits/tasks e finaliza como FAILED).

POSThttps://external-api.lip7.com.br/api/external/flows/executions/{id}/cancel

Escopoflows:triggerSíncrono — responde 200 com os dados

Idempotency-Key obrigatório

Envie o header Idempotency-Key. Sem ele a API responde 400 IDEMPOTENCY_KEY_REQUIRED.

Path params

idstringobrigatório

executionId.

Somente WAITING. Outros status → 400 EXECUTION_NOT_CANCELLABLE. Não existe status CANCELLED neste contrato.

Requisição

curl -X POST "https://external-api.lip7.com.br/api/external/flows/executions/{id}/cancel" \
  -H "x-api-key: lip_SUA_CHAVE" \
  -H "Idempotency-Key: chave-unica-001"

Resposta

{
  "success": true,
  "data": {
    "id": "exec_...",
    "status": "FAILED",
    "error": "Cancelado via API externa"
  }
}