---
title: "Get Timeline"
method: GET
path: "/optimisation/tasks/{task_id}/timeline"
tags: ["optimisation"]
---

# Get Timeline

`GET /optimisation/tasks/{task_id}/timeline`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/optimisation/tasks/{task_id}/timeline`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

What OS3's optimizer agent did on the task in the workspace, step by step.

## Path parameters

- `task_id` string, uuid, required

## Query parameters

- `workspace_id` string, uuid, required
- `after` integer
- `limit` integer

## Response `200`

Successful Response

- TaskTimeline: What OS3's optimizer agent did on a task in a workspace, oldest first. `state`: asleep (waiting for its next cue), planning, stopped (`stopped_reason` says why), or null before it first works on the task. Pass `next` as `after` for the next page, or the last event's id to ask for new steps.
  - `workspace_id` string, uuid, required
  - `task_id` string, uuid, required
  - `state` 'asleep' | 'planning' | 'stopped', nullable, required
  - `stopped_reason` string, nullable, required
  - `events` TimelineEvent[], required
    - `id` integer, required
    - `at` string, date-time, required
    - `kind` string, required
    - `cycle_id` string, uuid, nullable, required
    - `experiment_id` string, uuid, nullable, required
    - `detail` object, required
  - `next` integer, nullable, required

## Other responses

- `422`: Validation Error

---

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