List tasks
Lists tasks (the board query). Filter by workflow, state, status, automation status, assignee, or metadata — GET /tasks?workflow_id=...&state=... is one board column.
Request
- Base URL: https://api.naturali.ai
- URL: https://api.naturali.ai/v1/projects/{project_id}/tasks
- Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)
Query parameters
Filter by whether the task is open or closed. Repeat the parameter to OR values. A value outside the enum, empty string included, is a 400.
Filter by the current state's dispatch status. Repeat the parameter to OR values. none selects the tasks whose automation_status is null — the ones that never entered a state with an automation. It is a value a task really holds, so it is a value of the filter too; the parameter's own absence already means "every task".
A value outside the enum, empty string included, is a 400.
A MetadataFilter as JSON, url-encoded. It travels as JSON rather than as key:value pairs because the match is exact and a query string cannot otherwise say whether 3 is the number or the string.
Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.
Results to skip. Negative or not an integer it is 400.
Response
A list of tasks
Example response
{
"data": [
{
"workflow_version": 1,
"metadata": {
"author": "John",
"revision": 2
}
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.