Skip to main content
Native tasks, targets and assignment metadata.

Target Objects

Target identity and scope, without labels, media or subset contents.

DataUnitTarget Objects

An entire data unit, including a data group.

DataUnitSliceTarget Objects

A named slice of one data unit; range contents are not embedded.

DatasetTarget Objects

A whole dataset, without a single data-unit identifier.

DataGroupSubsetTarget Objects

A named subset of a data group; member contents are not embedded.

DatasetSubsetTarget Objects

A named dataset subset; member contents are not embedded.

UnknownTarget Objects

An unfamiliar target type; specialized access may require an SDK upgrade.

Assignment Objects

User assignment information, separate from task lifecycle.

Task Objects

One operation on a target at a stage, identified separately from the target.

ExternalTask Objects

A task at an External stage.

submit

Submit an entered External task, optionally selecting an outgoing pathway. Select an outgoing pathway by ID or exact, case-sensitive name, not both. With neither supplied, the stage must have exactly one outgoing pathway. Requires project management access. Success returns None and leaves this snapshot unchanged. A stale task raises StaleTaskError. Requests are not replayed after sending; a transport failure may leave the outcome uncertain. Backend validation determines action eligibility.

ManualTask Objects

A task supporting manual assignment and release.

assign

Assign this task to an eligible user by email, leaving this snapshot unchanged.

release

Release this task’s current assignment and claim without completing or moving it. Requires project management access and acts on the current assignment, not this snapshot’s holder. Releasing an unassigned task succeeds and clears any claim. Success leaves this snapshot unchanged.

AnnotationTask Objects

A task at an Annotation stage.

submit

Submit saved work through an outgoing pathway, leaving this snapshot unchanged. Select by ID or exact name, or omit both when the stage has exactly one outgoing pathway. Backend validation and permissions apply. Sent requests are not replayed.

ReviewTask Objects

A task at a Review stage.

submit

Submit through an outgoing pathway without changing individual label decisions. Native permissions and pathway rules apply. Success returns None and leaves this snapshot unchanged. Sent requests are not replayed.