---
title: "Create regression testing item"
method: POST
path: "/app/{appId}/regressionItem"
tags: ["regressionTesting"]
---

# Create regression testing item

`POST /app/{appId}/regressionItem`

## Request

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

Creates a new regression testing item for the app. For apps using FlightPaths with multiple destinations (e.g., separate iOS and Android regression testing steps), **include `stepConfigId`** in the request body to specify which regression testing step the item belongs to. When omitted, the first available regression testing step is used, which can be ambiguous in multi-destination FlightPaths. One-off items on FlightPaths apps can be created with an initial `status`.

## Path parameters

- `appId` string, required

## Request body

- CreateApprovalOrRegressionTestingItemRequestBody
  - `title` string, required: Title of the approval or regression testing item
  - `description` string: Description of the approval or regression testing item
  - `approverGroups` UserGroup[]: The list of user groups that can approve or update this item
  - `owners` string[]: List of user ids allowed to approve or update item
  - `notifyEnabled` boolean: Will send a notification when item is updated.
  - `oneOffForVersion` string: Nullable, approval or regression testing item will only appear in this version
  - `stepConfigId` string: Nullable - if using FlightPaths, the id of a specific approvals or regression testing step config for which to create the item
  - `status` 'approved' | 'rejected' | 'inProgress' | 'blocked' | 'passed' | 'failed': All possible statuses for a checklist item

## Response `200`

A checklist item response

- ChecklistItemEntity
  - `id` string, required: The identifier of the checklist item
  - `title` string, required: The title of the checklist item
  - `description` string: The description of the checklist item. Accepts markdown.
  - `approverGroups` UserGroup[], required: The list of user groups that can approve this checklist item. Custom groups can be included as well.
  - `releaseType` 'all' | 'hotfixOnly' | 'rollbackOnly' | 'allExceptHotfix', required: The type of release this checklist item will appear on
  - `notifyEnabled` boolean, required: Whether the checklist item will notify on Slack when its status changes
  - `statuses` ChecklistItemStatusType[], required: The list of possible checklist item status types for this checklist item. A subset of all possible ChecklistItemStatusType values
  - `releaseStepType` string: The release step that the checklist item appears on. Will be `null` if the placement of the item is not `binary`. Can either be of type ReleaseStepType, or a step's Step ID can be sent instead
  - `stepId` unknown
  - `oneOffForVersion` string: If the checklist item only applies for a single release version, this field will contain the version string for that version
  - `status` ChecklistItemStatus: The status of a checklist item
    - `status` 'approved' | 'rejected' | 'inProgress' | 'blocked' | 'passed' | 'failed', required: All possible statuses for a checklist item
    - `createdBy` string, required: The userId (email) of the user that created the checklist item
    - `createdAt` string, date-time, required: The date and time the checklist item was created
  - `placement` 'stepChecklist' | 'approvals' | 'regressionTesting', required: The placement of a given checklist item
  - `comment` ChecklistItemComment: A comment on a checklist item
    - `createdAt` string, date-time
    - `createdBy` string: The user id (email) of the user that added the comment
    - `comment` string: The comment string. Can be markdown.

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