Workflow v3.tasks
Native tasks, targets and assignment metadata.
Target identity and scope, without labels, media or subset contents.
An entire data unit, including a data group.
A named slice of one data unit; range contents are not embedded.
A whole dataset, without a single data-unit identifier.
A named subset of a data group; member contents are not embedded.
A named dataset subset; member contents are not embedded.
An unfamiliar target type; specialized access may require an SDK upgrade.
Assignment snapshot; assigned_to and assigned_by are opaque user IDs, not emails.
Read-only snapshot of one visit to a stage, identified separately from its target.
Actions leave this snapshot unchanged; use workflow.get_task() to refresh it.
Sent mutations are not automatically retried. A lost response may leave the
outcome uncertain; a stale-task error does not establish an earlier success.
A task at an External stage.
Submit an entered External task through an outgoing pathway.
Select by ID or exact, case-sensitive name, not both. Omit both only when
the stage has one outgoing pathway. Requires project management access.
Unavailable tasks raise StaleTaskError. Leaves this snapshot unchanged;
sent requests are not automatically retried.
A task supporting manual assignment and release.
Assign this task to an eligible user by email.
Non-managers may assign only to themselves. Leaves this snapshot unchanged;
sent requests are not automatically retried.
Release this task’s current assignment without completing or moving it.
Requires project management access and acts on the current assignment,
not this snapshot’s holder. Releasing a valid unassigned task succeeds.
Unavailable tasks raise StaleTaskError. Leaves this snapshot unchanged;
sent requests are not automatically retried.
A task at an Annotation stage.
Submit an Annotation task through an outgoing pathway; save labels separately first.
Select by ID or exact, case-sensitive name, not both. Omit both only when
the stage has one outgoing pathway. Non-managers must hold the assignment
and remain eligible to work at the stage. Comments require a DataUnitTarget.
Backend pathway rules apply. Leaves this snapshot unchanged; sent requests
are not automatically retried.
A task at a Review stage.
Submit through an outgoing pathway without changing individual label decisions.
Select by ID or exact, case-sensitive name, not both. Omit both only when
the stage has one outgoing pathway. Non-managers must hold the assignment
and remain eligible to work at the stage. Comments require a DataUnitTarget.
Backend pathway rules apply. Leaves this snapshot unchanged; sent requests
are not automatically retried.
Was this page helpful?

