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

> A Task represents an individual unit of work done by a contributor.

# Task

The work to be done is defined in the Task parameters. For example, a single Task might ask a contributor to have a conversation with a chat model and label all of the responses from the model. These labels are called [Annotations](/core-resources/annotation).

Scale API offers following endpoints to download tasks:

<AccordionGroup>
  <Accordion title="Retrieve a single task by identifiers">
    Check out the [Retrieve a Task](/v2/task) docs on how to get a single task by its identifiers.
  </Accordion>

  <Accordion title="List all tasks by search parameters">
    Check out the [Get Multiple Tasks](/v2/tasks) docs to learn more about how to download multiple tasks by different parameters like project, batch, status, or completion date.
  </Accordion>

  <Accordion title="Download tasks in a delivery">
    Check out the [Download tasks in a delivery](/v2/delivery) docs to download tasks in a specific delivery.
  </Accordion>
</AccordionGroup>

<ResponseExample>
  ```json Completed Task theme={null}
  {
    "task_id": "task_abc123",
    "project": "project_abc123",
    "batch": "batch_abc123",
    "status": "completed",
    "created_at": "2023-11-07T05:31:56Z",
    "completed_at": "2023-11-07T05:31:56Z",
    "metadata": {},
    "threads": [
      ...omitted...
    ]
  }
  ```

  ```json Pending Task theme={null}
  {
    "task_id": "task_abc123",
    "project": "project_abc123",
    "batch": "batch_abc123",
    "status": "pending",
    "created_at": "2023-11-07T05:31:56Z",
    "metadata": {}
  }
  ```

  ```json Errored Task theme={null}
  {
    "task_id": "task_abc123",
    "project": "project_abc123",
    "batch": "batch_abc123",
    "status": "error",
    "created_at": "2023-11-07T05:31:56Z",
    "metadata": {},
    "errors": [
      {
        "type": "UNSUPPORTED_LANGUAGE",
        "message": "The specified language or locale is not supported"
      }
    ]
  }
  ```

  ```json Reported Task theme={null}
  {
    "task_id": "task_abc123",
    "project": "project_abc123",
    "batch": "batch_abc123",
    "status": "error",
    "created_at": "2023-11-07T05:31:56Z",
    "metadata": {},
    "sensitive_content_reports": [
      {
        "type": "violence",
        "message": "The prompt in the task promotes violence."
      }
    ]
  }
  ```
</ResponseExample>