---
title: "Create a triage issue"
method: POST
path: "/app/{appId}/triageIssue"
tags: ["triage"]
---

# Create a triage issue

`POST /app/{appId}/triageIssue`

## Request

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

Creates a new triage issue on the app. Requires Triage to be enabled on the app.

## Path parameters

- `appId` string, required

## Request body

- CreateTriageIssueRequestBody
  - `description` string: Optional description of the triage issue
  - `reporter` string: Email of the user reporting the issue. Required unless the request is authenticated as a Runway user, in which case it defaults to that user
  - `title` string, required: Title for the issue.
  - `version` string: Optional version string the issue applies to
  - `build` string: Optional build identifier the issue applies to

## Response `200`

A triage issue response

- TriageIssueEntity: A triage issue.
  - `id` string: Unique identifier for the issue
  - `appId` string
  - `title` string: Title for the issue. Always present: issues without their own title fall back to the text of their first source, then to "Triage issue <id>" — matching what the Runway UI displays.
  - `state` 'new' | 'assigned' | 'fixRequested' | 'fixApproved' | 'reopened' | 'fixMerged' | 'fixRejected' | 'notAPriority': Current state of the issue
  - `reporter` string, nullable: Email of the user who reported the issue
  - `assigneeUserIds` string[]: Emails of the people assigned. Agents are listed in assigneeAgentIds, not here
  - `assigneeAgentIds` string[]: Ids of the agents the issue is assigned to
  - `suggestedAssigneeUserIds` string[]: Additional candidates surfaced by the auto-assign automation
  - `sources` TriageIssueSource[]: The signals that contributed to this issue (Runway-reported, PM ticket, user reviews, regression test failures, health metrics, beta feedback)
    - `type` 'runway' | 'pmTicket' | 'userReviews' | 'betaFeedback' | 'regressionTesting' | 'healthMetrics', required: Origin of the source signal
    - `description` string: Human-readable description for this source (e.g. the reported message for `runway`, the failed test case for `regressionTesting`, the ticket description for `pmTicket`)
    - `version` string: Version string the source applies to, when known
    - `build` string: Build identifier the source applies to, when known
  - `relatedIssueIds` string[]
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

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