> ## Documentation Index
> Fetch the complete documentation index at: https://plain-docs-orca-916-agent-docs-restructure.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch tasks

> Fetch tasks by ID, by their short reference, or as a paginated collection.

There are three ways to fetch tasks:

* [Get tasks](#get-tasks): paginated collection
* [Get task by ID](#get-task-by-id)
* [Get task by ref](#get-task-by-ref). `ref` is the short human-readable identifier shown in the Plain app (e.g. `T-123`)

<Snippet file="graphql/sdk-note.mdx" />

These operations require the following permissions:

* `task:read`

## Get tasks

<Snippet file="graphql/get-tasks.mdx" />

## Get task by ID

<Snippet file="graphql/get-task-by-id.mdx" />

## Get task by ref

<Snippet file="graphql/get-task-by-ref.mdx" />