---
title: "GET /experimental/tasks/{id}/runs"
method: GET
path: "/experimental/tasks/{id}/runs"
tags: ["Tasks"]
---

# GET /experimental/tasks/{id}/runs

`GET /experimental/tasks/{id}/runs`

List a task's `launch_run`s newest-first, each with status, failureReason, the skill's summary and links, the schema snapshots the run enforced, the `run.created`/`run.finished` event ids, and its `resumeOfLaunchRunId` lineage.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `sort` union
  - union[]
    - union
      - 'id'
      - '-id'
  - 'id'
  - '-id'
- `page[size]` integer
- `page[after]` string
- `page[before]` string

## Headers

- `Authorization` string

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
    - `next` string, uri, nullable, required
    - `prev` string, uri, nullable, required
  - `meta` object, required
    - `count` number, required
  - `data` object[], required
    - `id` string, uuid, required
    - `type` 'launch-run', required
    - `attributes` object, required
      - `status` string, required
      - `failureReason` object, nullable, required
      - `links` object[]
        - `type` string, required
        - `value` string, required
        - `eventId` string, uuid, nullable, required
        - `displayLabel` string
        - `displayTitle` string
        - `displayUrl` string
      - `summary` string
      - `summaryTruncated` true
      - `outputSchema` object
      - `inputSchema` object
      - `runCreatedEventId` string, uuid, nullable, required
      - `runFinishedEventId` string, uuid, nullable, required
      - `resumeOfLaunchRunId` string, uuid, nullable, required
      - `createdAt` string, date-time, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-09-15** `d50a02b79ad3` — 2 info
  - added the optional property `error/code` to the response with the `403` status
  - added the optional property `error/url` to the response with the `403` status
- **2026-09-08** `78f96a975834` — 1 info
  - added the optional property `data/items/attributes/summaryTruncated` to the response with the `200` status
- **2026-09-04** `ffb03b5d287f` — 1 breaking, 7 info
  - removed the required property `data/items/attributes/runCompletedEventId` from the response with the `200` status
  - added the new optional `query` request parameter `page[after]`
  - added the new optional `query` request parameter `page[before]`
  - added the new optional `query` request parameter `page[size]`
  - …4 more

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/tasks/:id/runs/get.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) · [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tessl/apis/tessl-api/revisions/ee9b4e55fec4?raw)
