For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
List all Tasks created in the specified Site, across every Rack and Tray.
Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix, and the Site must belong to that Provider and have NICo Flow enabled.
Setting `activeOnly=true` restricts the result to tasks in a non-terminal REST state (`Pending` or `Running`). Results are ordered by creation time descending, then Task UUID descending, before pagination. The `X-Pagination` response header reports the total count over the post-filter set.
By default the `report` field is omitted from each Task in the response. Set `includeReport=true` to include it; this is opt-in because report bodies can be several KB.
Authentication
AuthorizationBearer
```
export JWT_BEARER_TOKEN="<jwt-bearer-token>"
# Example org name: "acme-inc
export ORG_NAME=<org-name>
# Use the JWT bearer token in your API request auth header:
curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current
```
Path parameters
orgstringRequired
Name of the Org
Query parameters
siteIdstringRequiredformat: "uuid"
ID of the Site whose Tasks are returned.
activeOnlybooleanOptionalDefaults to false
Restrict results to non-terminal Tasks.
includeReportbooleanOptionalDefaults to false
Include the per-task execution report on each returned Task.
pageNumberintegerOptional1-21474836
Page number for pagination query.
pageSizeintegerOptional1-100Defaults to 20
Number of Tasks returned per page.
Response headers
X-PaginationstringOptional
Pagination result in JSON format.
Response
OK
idstringOptionalformat: "uuid"
Unique identifier of the task.
statusenumOptional
Current state of the task.
descriptionstringOptional
Human-readable description provided when the task was created.
messagestringOptional
Optional status or error message describing the current state or result.
ruleIdstring or nullOptionalformat: "uuid"
Operation Rule that Flow resolved for this task — either because
the caller pinned one via ruleId on the originating request or
because Flow’s default rule resolution picked it. Null if Flow
has not yet recorded a resolution.
starteddatetimeOptional
Timestamp when the task started execution.
finisheddatetimeOptional
Timestamp when the task finished (succeeded, failed or terminated).
createddatetimeOptional
Timestamp when the task was created.
updateddatetimeOptional
Timestamp when the task was last updated.
reportobjectOptional
Structured v1 execution report for the task. Populated on single-task GET and cancel responses, and on list responses only when includeReport=true is set. Omitted when the task has not yet produced a report (e.g. still queued) or when the caller did not opt in on list endpoints.
A future schema revision will be exposed as a new TaskReportV2 schema referenced from a parallel response field; v1 consumers are not disturbed by that bump.
Errors
400
Bad Request Error
403
Forbidden Error
412
Precondition Failed Error
500
Internal Server Error
504
Gateway Timeout Error
List all Tasks created in the specified Site, across every Rack and Tray.
Org must have an Infrastructure Provider entity. User must have authorization role with PROVIDER_ADMIN suffix, and the Site must belong to that Provider and have NICo Flow enabled.
Setting activeOnly=true restricts the result to tasks in a non-terminal REST state (Pending or Running). Results are ordered by creation time descending, then Task UUID descending, before pagination. The X-Pagination response header reports the total count over the post-filter set.
By default the report field is omitted from each Task in the response. Set includeReport=true to include it; this is opt-in because report bodies can be several KB.
export JWT_BEARER_TOKEN="<jwt-bearer-token>"
# Example org name: "acme-inc
export ORG_NAME=<org-name>
# Use the JWT bearer token in your API request auth header:
