tasks

Add a task to a flow

Creates a task and links it in the same call. after are the tasks that must finish first; before are the tasks that now wait on this one — use it to insert a step into an existing chain.

post/v1/flows/{flowId}/tasks

Request

  • Base URL: https://api.flowral.app
  • URL: https://api.flowral.app/v1/flows/{flowId}/tasks
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (client credentials, token URL https://api.flowral.app/v1/oauth/token, scopes: flows:write)

Path parameters

flowIdstring required

Request body

namestring required
descriptionstring
afterstring[]

Task ids this depends on.

beforestring[]

Task ids that should depend on this.

estimateHoursnumber
assigneeIdstring

Response

CREATED

idstring required
flowIdstring required
parentIdstring nullable required

Set when this is a sub-task — the objective it belongs to. Null for an objective itself.

namestring required
descriptionstring nullable
status'blocked' | 'ready' | 'in_progress' | 'done' required

Derived from the graph on read, never stored. Work moves ready → in_progress → done; nothing jumps straight to done.

dependsOnstring[] required

Task ids that must be done first.

blockedBystring[]

Of those, the ones not yet done. Empty when status is not "blocked".

assigneeIdstring nullable
estimateHoursnumber nullable
criticalPathboolean

True when this task is on the chain that decides the flow's finish date.

Example response

{
  "id": "tsk_9f2c41"
}

Changes

No recorded changes to this operation across all 1 revision of this API.