---
title: "Get timeline events for a release"
method: GET
path: "/app/{appId}/release/{releaseId}/timelineEvents"
tags: ["release"]
---

# Get timeline events for a release

`GET /app/{appId}/release/{releaseId}/timelineEvents`

## Request

- Base URL: `https://api.runway.team`
- URL: `https://api.runway.team/app/{appId}/release/{releaseId}/timelineEvents`
- Auth: API key in header `X-API-Key`

Get timeline events for a release. Use these to see what happened and in what order — never to compute durations; timeline events are not reliable timestamps for how long anything took. For step durations and review timing, use the release step endpoints instead.

## Path parameters

- `appId` string, required
- `releaseId` string, required

## Response `200`

A list of timeline events

- PublicTimelineEvent[]
  - `appId` string, required: The id of the app this event belongs to
  - `eventData` object, nullable: The data associated with the timeline event
  - `orgId` string, required: The id of the organization this event belongs to
  - `releaseData` object, nullable: Release-specific data for this event
  - `releaseId` string, nullable: The id of the release this event is associated with
  - `status` 'active' | 'completed' | 'canceled', required: The status of the timeline event
  - `triggeredAt` string, date-time, required: When the event was triggered
  - `triggeredBy` object, nullable: Information about who or what triggered this event
  - `type` string, required: The type of timeline event
  - `userId` string, nullable: The id of the user who triggered the event
  - `stepArchetypes` string[]: The step archetypes associated with this event
  - `automationData` object, nullable: Automation-specific data for this event
  - `additionalData` object, nullable: Additional metadata associated with the event
  - `title` string: The title of the event
  - `previouslySeenAt` string[]: Timestamps when this event was previously seen
  - `workflowRunId` string, nullable: The id of the FlightPath run this event belongs to
  - `stepRunId` string, nullable: The id of the step run this event belongs to
  - `destinationStepConfigIds` string[]: The destination step config ids for this event
  - `stepConfigIds` string[]: The step config ids that this event should be shown at

## Other responses

- `400`: Bad request response
- `404`: Resource not found response

---

[API](https://skmtc.dev/runway/apis/runway-rest-api.md) - [All operations](https://skmtc.dev/runway/apis/runway-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runway/apis/runway-rest-api/revisions/081109863a9a?raw)