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

# Assign and query tasks with the SDK

> Use the RedBrick AI Python SDK to search project tasks by name, list tasks by stage, and programmatically assign or unassign tasks to specific users.

The SDK offers multiple ways to query/search through your project tasks and programmatically assign them to various users. 

## Search by Task Name

Use `list_tasks` to search for tasks by `name` and get their corresponding `task_id`. Often, you will have Task `name`s readily accessible, and can use `list_tasks` to get the corresponding `task_id,` which may be needed in other SDK functions. 

<Check>
  Please see a detailed reference for [`list_tasks`
  here](https://sdk.redbrickai.com/sdk.html#redbrick.export.Export.search_tasks).
</Check>

```python theme={null}
project = redbrick.get_project(org_id, project_id, api_key)

tasks = project.export.list_tasks() # fetches all tasks
specific_task = project.list_tasks(task_name="...") # fetches specific task by name
```

***

## Assign Tasks to a User

Use `assign_task` when you already have the `task_id` you want to assign to a particular user. If you don’t have the `task_id`, you can query all the Tasks using [`list_tasks`](./exporting-annotations#export-all-tasks) or query tasks assigned to a particular user/unassigned tasks using [`list_tasks(user_id="...")`](./assigning-and-querying-tasks#retrieve-queued-tasks).

#### Assign to a Specific User

```python theme={null}
project = redbrick.get_project(org_id, project_id, api_key)

---
title: Assign tasks in Label stage to a specific user
---
project.labeling.assign_tasks(task_ids=["..."], email="...")

---
title: Assign tasks in Review stage to specific user
---
project.review.assign_tasks(task_ids=["..."], email="...")
```

***

## Retrieve Queued Tasks

Use `list_tasks` in conjunction with a specific `user_id` when you want to retrieve the Tasks assigned to a particular user. This can be useful in preparation for using [`assign_tasks`](./assigning-and-querying-tasks#assign-tasks-to-a-user) to programmatically assign unassigned tasks, or [`put_tasks`](./programmatic-label-and-review) to programmatically label/review tasks assigned to you.

### Retrieve Tasks Assigned to Specific User

```python theme={null}
project = redbrick.get_project(org_id, project_id, api_key)

---
title: Get Tasks assigned to email@email.com in Label Stage
---
project.export.list_tasks(labeling.(stage_name="Label", user_id="email@email.com")

---
title: Get Tasks assigned to email@email.com in Review_1 Stage
---
project.export.list_tasks(stage_name="Review_1", user_id="email@email.com")
```

### Retrieve Unassigned Tasks

You can also fetch all unassigned Tasks in a particular stage. This information may be useful when choosing which Tasks to assign to users.&#x20;

```python theme={null}
project = redbrick.get_project(org_id, project_id, api_key)

---
title: Get unassigned tasks in Label labeling stage
---
project.export.list_tasks(redbrick.TaskFilters.UNASSIGNED, stage_name="Label")

---
title: Get unassigned tasks in Review_1 review stage
---
project.export.list_tasks(redbrick.TaskFilters.UNASSIGNED, stage_name="Review_1")
```

***

## Retrieve Tasks Assigned to You

With the correct configuration of list\_tasks(), you can perform functions as specific as retrieving a list of Tasks from a specific Stage to your specific API key. Please see the code snippet below for an example:

```python theme={null}
project = redbrick.get_project(org_id, project_id, api_key)

---
title: Get tasks assigned to your API key in Label stage
---
project.export.list_tasks(
    redbrick.TaskFilters.QUEUED,
    stage_name="Label",
    user_id=project.context.key_id
    )
```