Tasks
Individual steps inside an Assembly. A task represents a single unit of work — a transform, a render, a publication step, a notification — with its own status and output.
Tasks are read-mostly; the runtime creates and updates them automatically. The only write operation is deletion. They share the assemblies:* scopes with Assemblies because they live in the same execution-history domain.
Scopes
| Scope | Reach |
|---|---|
assemblies:read | Listing, reading, viewing filters. |
assemblies:write | Deleting tasks. |
Endpoints
List Tasks
GET /api/factory/tasks/
Returns a page of task records.
Required scope: assemblies:read · also accepts API key
Query parameters — standard pagination set; see Conventions › Pagination. Defaults: sort_by=created, sort_order=desc, hydrate=true.
Response 200 — TaskInDbCursorPage
Get Task Filter Metadata
GET /api/factory/tasks/filters
Returns filter/operator/sort options for List Tasks.
Required scope: assemblies:read
Response 200 — open metadata object.
Get Task by ID
GET /api/factory/tasks/{id}
Returns a single task with its full status payload.
Required scope: assemblies:read · also accepts API key
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | yes | Task ID. |
Response 200 — TaskRead
Delete Task by ID
DELETE /api/factory/tasks/{id}
Removes a task record. The owning Assembly is unaffected, but its task list will no longer include the deleted entry.
Required scope: assemblies:write
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | yes | Task ID. |
Response 204 — empty.
See also
- Assemblies — the parent record of a task.
- Blueprints — the workflow definition tasks correspond to.