> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encord.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflow v3.tasks

Native tasks, targets and assignment metadata.

## Target Objects

```python theme={"dark"}
@dataclass(frozen=True)
class Target()
```

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

## DataUnitTarget Objects

```python theme={"dark"}
@dataclass(frozen=True)
class DataUnitTarget(Target)
```

An entire data unit, including a data group.

## DataUnitSliceTarget Objects

```python theme={"dark"}
@dataclass(frozen=True)
class DataUnitSliceTarget(Target)
```

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

## DatasetTarget Objects

```python theme={"dark"}
@dataclass(frozen=True)
class DatasetTarget(Target)
```

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

## DataGroupSubsetTarget Objects

```python theme={"dark"}
@dataclass(frozen=True)
class DataGroupSubsetTarget(Target)
```

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

## DatasetSubsetTarget Objects

```python theme={"dark"}
@dataclass(frozen=True)
class DatasetSubsetTarget(Target)
```

A named dataset subset; member contents are not embedded.

## UnknownTarget Objects

```python theme={"dark"}
@dataclass(frozen=True)
class UnknownTarget(Target)
```

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

## Assignment Objects

```python theme={"dark"}
@dataclass(frozen=True)
class Assignment()
```

Assignment snapshot; assigned\_to and assigned\_by are opaque user IDs, not emails.

## Task Objects

```python theme={"dark"}
@dataclass(frozen=True)
class Task()
```

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.

## ExternalTask Objects

```python theme={"dark"}
@dataclass(frozen=True)
class ExternalTask(Task)
```

A task at an External stage.

#### submit

```python theme={"dark"}
def submit(*,
           pathway_id: Optional[Union[UUID, str]] = None,
           pathway_name: Optional[str] = None) -> None
```

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.

## ManualTask Objects

```python theme={"dark"}
@dataclass(frozen=True)
class ManualTask(Task)
```

A task supporting manual assignment and release.

#### assign

```python theme={"dark"}
def assign(assignee: str) -> None
```

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

```python theme={"dark"}
def release() -> None
```

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.

## AnnotationTask Objects

```python theme={"dark"}
@dataclass(frozen=True)
class AnnotationTask(ManualTask)
```

A task at an Annotation stage.

#### submit

```python theme={"dark"}
def submit(*,
           pathway_id: Optional[Union[UUID, str]] = None,
           pathway_name: Optional[str] = None,
           comment: Optional[str] = None) -> None
```

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.

## ReviewTask Objects

```python theme={"dark"}
@dataclass(frozen=True)
class ReviewTask(ManualTask)
```

A task at a Review stage.

#### submit

```python theme={"dark"}
def submit(*,
           pathway_id: Optional[Union[UUID, str]] = None,
           pathway_name: Optional[str] = None,
           comment: Optional[str] = None) -> None
```

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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.