# Criar tarefa do fluxo

Criar tarefa do fluxo. Consulte abaixo parâmetros, corpo da requisição e respostas definidos no contrato OpenAPI.

Source: https://zild.ai/pt-BR/docs/api-reference/post-api-FlowTask

POST `/FlowTask`

Criar tarefa do fluxo. Consulte abaixo parâmetros, corpo da requisição e respostas definidos no contrato OpenAPI.

## Autenticação

**Autenticação obrigatória.** Envie sua chave de API de usuário no header X-API-Key.

## Parâmetros

Esta operação não possui parâmetros de rota, query ou header.

## Corpo da requisição

**Content type:** `application/json` · **Schema:** `FlowTaskDto`



<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>flowId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>currentFlowStageId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>title</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>description</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>status</code></td><td><code>FlowTaskStatus</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>priority</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>payload</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>dueDate</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>createdAt</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>createdBy</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>completedAt</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>canceledAt</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>flowRecurringTaskId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>recurringOccurrenceAtUtc</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>scheduledOccurrenceAtUtc</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr></tbody></table>



## Exemplo de requisição



```
curl --request POST \
  --url 'https://api.zild.ai/FlowTask' \
  --header 'X-API-Key: YOUR_USER_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 0,
  "flowId": 0,
  "currentFlowStageId": 0,
  "title": "string",
  "description": "string",
  "status": 0,
  "priority": 0,
  "payload": "string",
  "dueDate": "2026-09-22T18:00:00Z",
  "createdAt": "2026-09-22T18:00:00Z",
  "createdBy": 0,
  "completedAt": "2026-09-22T18:00:00Z",
  "canceledAt": "2026-09-22T18:00:00Z",
  "flowRecurringTaskId": 0,
  "recurringOccurrenceAtUtc": "2026-09-22T18:00:00Z",
  "scheduledOccurrenceAtUtc": "2026-09-22T18:00:00Z"
}'
```



## Respostas



<table class="api-params"><thead><tr><th>Status</th><th>Descrição</th><th>Corpo da resposta</th></tr></thead><tbody><tr><td><code>200</code></td><td>OK</td><td>Nenhum corpo de resposta está definido.</td></tr></tbody></table>



## Modelos de dados

`FlowTaskDto`

<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>flowId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>currentFlowStageId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>title</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>description</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>status</code></td><td><code>FlowTaskStatus</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>priority</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>payload</code></td><td><code>string</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>dueDate</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>createdAt</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>createdBy</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>completedAt</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>canceledAt</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>flowRecurringTaskId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>recurringOccurrenceAtUtc</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr><tr><td><code>scheduledOccurrenceAtUtc</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>aceita null</td></tr></tbody></table>

`FlowTaskStatus`0 = Pending; 1 = InProgress; 2 = Completed; 3 = Canceled

`integer`