---
title: "List tasks for repository"
method: GET
path: "/agents/repos/{owner}/{repo}/tasks"
tags: ["agent-tasks"]
---

# List tasks for repository

`GET /agents/repos/{owner}/{repo}/tasks`

> [!NOTE]
> This endpoint is in public preview and is subject to change.

Returns a list of tasks for a specific repository

**Fine-grained access tokens for "List tasks for repository"**

This endpoint works with the following fine-grained token types:

* [GitHub App user access tokens](https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app)
* [Fine-grained personal access tokens](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token)

The fine-grained token must have the following permission set:

* "Agent tasks" repository permissions (read)

GitHub App installation access tokens are not supported for this endpoint.

## Path parameters

- `owner` string, required
- `repo` string, required

## Query parameters

- `per_page` integer
- `page` integer
- `sort` 'updated_at' | 'created_at'
- `direction` 'asc' | 'desc'
- `state` string
- `is_archived` boolean
- `since` string, date-time
- `creator_id` integer[]

## Response `200`

Tasks retrieved successfully

- object
  - `tasks` object[], required — List of tasks
    - `id` string, required — Unique task identifier
    - `url` string — API URL for this task
    - `html_url` string — Web URL for this task
    - `name` string — Human-readable name derived from the task prompt
    - `creator` object — A GitHub user
      - `id` integer — The unique identifier of the user
    - `creator_type` 'user' | 'organization' — Type of the task creator
    - `user_collaborators` object[] — User objects of collaborators on this task
      - `id` integer — The unique identifier of the user
    - `owner` object — The owner of the repository
      - `id` integer — The unique identifier of the user
    - `repository` object — The repository this task belongs to
      - `id` integer — The unique identifier of the repository
    - `state` 'queued' | 'in_progress' | 'completed' | 'failed' | 'idle' | 'waiting_for_user' | 'timed_out' | 'cancelled', required — Current state of the task, derived from its most recent session
    - `session_count` integer — Number of sessions in this task
    - `artifacts` object[] — Resources created by this task (PRs, branches, etc.)
      - `provider` 'github', required — Provider namespace
      - `type` 'pull' | 'branch', required — Type of artifact. Available Values: `pull`, `branch`.
      - `data` union, required — Resource data (shape depends on type)
        - object — A GitHub resource (pull request, issue, etc.)
          - `id` integer, required — GitHub resource ID
          - `global_id` string — GraphQL global ID
        - object — A Git branch reference
          - `head_ref` string, required — Head branch name
          - `base_ref` string, required — Base branch name
    - `archived_at` string, date-time, nullable — Timestamp when the task was archived, null if not archived
    - `updated_at` string, date-time — Timestamp of the most recent update
    - `created_at` string, date-time, required — Timestamp when the task was created
    - `custom_agent` object — Custom agent metadata associated with this task
      - `id` string — The custom agent's filename without the extension - for example, `performance-optimizer` for a `.github/agents/performance-optimizer.agent.md` custom agent.
  - `total_active_count` integer — Total count of active (non-archived) tasks
  - `total_archived_count` integer — Total count of archived tasks

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `403` — Insufficient permissions
- `404` — Resource not found
- `422` — Validation Failed

---

[API](https://skmtc.net/github/apis/rest-api.md) · [All operations](https://skmtc.net/github/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/rest-api/versions/80850db290cd/schema)