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

# Tasks

> Production tasks, their comments, checklists and attachments.

Use the operations below to work with tasks. Each link opens an interactive reference page generated from the published OpenAPI specification.

## Operations

| Operation                                                                                  | Method and path                              | Required scopes |
| ------------------------------------------------------------------------------------------ | -------------------------------------------- | --------------- |
| [Production tasks assigned to one person](/api/reference/get_v1_tasks_by_assignee)         | `GET /v1/tasks/by-assignee`                  | `tasks.read`    |
| [A task’s comments, checklist and attachments](/api/reference/get_v1_tasks_taskId_extras)  | `GET /v1/tasks/{taskId}/extras`              | `tasks.read`    |
| [Create a production task](/api/reference/post_v1_tasks)                                   | `POST /v1/tasks`                             | `tasks.write`   |
| [Update a production task](/api/reference/patch_v1_tasks_taskId)                           | `PATCH /v1/tasks/{taskId}`                   | `tasks.write`   |
| [Delete a production task](/api/reference/delete_v1_tasks_taskId)                          | `DELETE /v1/tasks/{taskId}`                  | `tasks.write`   |
| [Patch every production task matching a target](/api/reference/post_v1_tasks_bulk_update)  | `POST /v1/tasks/bulk/update`                 | `tasks.write`   |
| [Delete every production task matching a target](/api/reference/post_v1_tasks_bulk_delete) | `POST /v1/tasks/bulk/delete`                 | `tasks.write`   |
| [Comment on a production task](/api/reference/post_v1_tasks_taskId_comments)               | `POST /v1/tasks/{taskId}/comments`           | `tasks.write`   |
| [Edit a task comment](/api/reference/patch_v1_task_comments_commentId)                     | `PATCH /v1/task-comments/{commentId}`        | `tasks.write`   |
| [Delete a task comment](/api/reference/delete_v1_task_comments_commentId)                  | `DELETE /v1/task-comments/{commentId}`       | `tasks.write`   |
| [Add a checklist item to a task](/api/reference/post_v1_tasks_taskId_checklist)            | `POST /v1/tasks/{taskId}/checklist`          | `tasks.write`   |
| [Update a checklist item](/api/reference/patch_v1_task_checklist_items_itemId)             | `PATCH /v1/task-checklist-items/{itemId}`    | `tasks.write`   |
| [Delete a checklist item](/api/reference/delete_v1_task_checklist_items_itemId)            | `DELETE /v1/task-checklist-items/{itemId}`   | `tasks.write`   |
| [Attach a file to a task](/api/reference/post_v1_tasks_taskId_attachments)                 | `POST /v1/tasks/{taskId}/attachments`        | `tasks.write`   |
| [Remove a task attachment](/api/reference/delete_v1_task_attachments_attachmentId)         | `DELETE /v1/task-attachments/{attachmentId}` | `tasks.write`   |

See [Authentication](/api/authentication) before your first call. For write retries, see [Writing safely](/api/idempotency).