Skip to content

Executar fluxo manualmente​

POST
/tenant/flows/run

Força a execução imediata de um flow específico.

Comportamento

  1. Valida se o flow existe e está ativo
  2. Envia comando de execução para o agente ETL
  3. Retorna imediatamente (execução é assíncrona)

Importante: A execução é assíncrona. O retorno success: true indica
que o comando foi enviado, não que o flow foi concluído.

Parâmetro Context

O campo context é obrigatório e define o modo de carga do flow:

Context Descrição
Total Carga total - substitui todos os dados
Incremental Carga incremental - apenas novos/alterados
Temporal:* Carga temporal - período específico

Formatos Temporais

Para cargas temporais, use o formato Temporal:tipo:valor:

Formato Exemplo Descrição
Temporal:Days:N Temporal:Days:30 Últimos N dias
Temporal:Future:N Temporal:Future:7 Próximos N dias
Temporal:Year:AAAA Temporal:Year:2024 Ano específico
Temporal:Month:MM-AAAA Temporal:Month:01-2024 Mês específico

Mensagens de Erro

Mensagem Causa
Flow não encontrado ID não existe ou flow está inativo

Autorizações​

tenantBearerAuth

Token de acesso do tenant

TipoHTTP (bearer)

Corpo da Requisição​

application/json
JSON
{
"flowId": 1,
"context": "Total"
}

Respostas​

Comando de execução enviado

application/json
JSON
{
"status": "success",
"data": true
}

Playground​

Autorização
Corpo

Exemplos​

Desenvolvido por VitePress OpenAPI