---
title: "Get release schedule cadence"
method: GET
path: "/app/{appId}/scheduleCadence"
tags: ["app"]
---

# Get release schedule cadence

`GET /app/{appId}/scheduleCadence`

## Request

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

Returns the app's release schedule cadence — how often releases happen (weekly / biweekly / monthly / etc.), the target kickoff/submit/release day-and-time pattern, timezone, and skip-next-submit/release flags.

## Path parameters

- `appId` string, required

## Response `200`

The release schedule cadence configuration for an app

- ScheduleCadenceEntity
  - `scheduleCadence` 'never' | 'weekly' | 'biweekly' | 'threeWeeks' | 'monthly' | 'sixWeeks', required: How often releases recur.
  - `cadenceTargetDateSets` CadenceTargetSetEntity[], required: The target day-of-week and time-of-day for kickoff, submit, and release within each cadence period. Typically one element; weekly cadences configured for multiple releases per week may have more.
    - `kickoffDayOfWeek` string, nullable: Lowercase weekday name, e.g. "monday".
    - `kickoffTimeHour` integer, nullable: Hour of day, 0-23.
    - `kickoffTimeMinute` integer, nullable: Minute of hour, 0-59.
    - `submitDayOfWeek` string, nullable
    - `submitTimeHour` integer, nullable
    - `submitTimeMinute` integer, nullable
    - `releaseDayOfWeek` string, nullable
    - `releaseTimeHour` integer, nullable
    - `releaseTimeMinute` integer, nullable
  - `cadenceTimezone` string, nullable: IANA timezone name (e.g. America/Los_Angeles) used for the target dates above.
  - `allowKickoffWhenPreviousNotComplete` boolean, nullable: Whether a new release is allowed to kick off before the previous one is completed.
  - `submitWeeksToSkip` integer, required: Number of weeks past the next possible submit date to schedule submission. 0 uses the next possible date.
  - `releaseWeeksToSkip` integer, required: Number of weeks past the next possible release date to schedule release. 0 uses the next possible date.

## Other responses

- `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)