---
title: "List tasks for the user's organisations"
method: GET
path: "/api/v1/tasks"
tags: ["tasks-dashboard"]
---

# List tasks for the user's organisations

`GET /api/v1/tasks`

## Request

- Base URL: `https://api.qualityclouds.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qualityclouds.ai/api/v1/tasks`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

RSQL `search`: required `status=in=(S1,S2)`; optional `repository_id==<id>`. Without `repository_id`, returns tasks for all orgs in the JWT (org-scoped and repo-linked tasks). With `repository_id`, restricts to that repo (still org-scoped). Sort: `sort=created_at` (asc) or `sort=-created_at` (desc, default). Pagination: `cursor` (opaque), `limit` (1–100).

## Query parameters

- `search` string, required: Example: status=in=(PENDING,QUEUED) or repository_id==repo-uuid;status=in=(PENDING)
- `sort` string, nullable: `created_at` ascending or `-created_at` descending (default if omitted)
- `cursor` string, nullable: Opaque cursor from previous response
- `limit` integer, nullable: Page size (default 20, max 100)

## Response `200`

Successful Response

- PagedTasksResponse
  - `items` TaskResponse[], required
    - `id` string, uuid, required
    - `name` string, required
    - `task_type` string, required
    - `status` string, required
    - `target_id` string, required
    - `repo_id` string, required
    - `category` string, nullable
    - `input_payload` object, nullable
    - `result_payload` object, nullable
    - `execution_log` string, nullable
    - `created_at` string, date-time, required
    - `started_at` string, date-time, nullable
    - `ended_at` string, date-time, nullable
    - `created_by` string, nullable
    - `approved_by` string, nullable
    - `approved_at` string, date-time, nullable
    - `description` string, nullable
    - `link` string, nullable
  - `next_cursor` string, nullable
  - `prev_cursor` string, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error

---

[API](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api.md) · [All operations](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/revisions/250c849925af?raw)