---
title: "Save timeline events"
method: POST
path: "/timeline"
tags: ["timeline"]
---

# Save timeline events

`POST /timeline`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/timeline`
- Auth: none declared
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/timeline/post.ts> (a function with typed inputs; its response is checked against the schema)

Save timeline events and returns timeline settings

## Request body

- ModelsTimelineEvent[]
  - `desktop_id` string
  - `end_time` integer
  - `filename` string
  - `id` integer
  - `idle` boolean
  - `start_time` integer
  - `title` string

## Response `200`

OK

- ModelsTimelineSettings
  - `record_timeline` boolean

## Other responses

- `400`: Invalid JSON input
- `503`: Timeline upload is temporarily unavailable

---

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