---
title: "Request a fix for a triage issue"
method: POST
path: "/app/{appId}/triageIssue/{issueId}/requestFix"
tags: ["triage"]
---

# Request a fix for a triage issue

`POST /app/{appId}/triageIssue/{issueId}/requestFix`

## Request

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

Escalates an existing triage issue to a fix request on the given release: the issue moves to `fixRequested` and a fix request is created on that release to carry the work. Requires Triage to be enabled on the app.

A fix maps to a single feature readiness item, so `workItems` takes at most one code item (PR or commit) and at most one ticket — anything more returns 400. At least one work item is required unless the app's "create PM ticket on triage issue fix request" automation is enabled, in which case a ticket is created and associated automatically. The call returns 400 if the selected code or ticket is already associated with another fix on that release.

## Path parameters

- `appId` string, required
- `issueId` string, required

## Request body

- object
  - `version` string, required: The release the fix should land in (e.g. "1.2.3")
  - `formFieldsValues` FixRequestFormFieldValue[]: Values for the app's configured fix request form fields, each keyed by the field's `fieldId` (from GET /app/{appId}/fixRequestFormFieldsSettings).
    - `fieldId` string: The id of the form field this value is for (from FixRequestFormFieldSettings).
    - `value` string: The value supplied for the field.
  - `workItems` object[]: The work that fixes the issue: at most one code item (PR or commit) and at most one ticket.
    - `id` string, required: The Feature Readiness work item id
    - `pullRequestNumber` integer: Set if the work item is an open PR
    - `ticketKey` string: Optional ticket key
    - `ticketUrl` string: Optional ticket URL

## Response `200`

The escalated triage issue and the fix request created for it

- object
  - `issue` TriageIssueEntity, required: 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
  - `version` string, required: The release the fix was requested on
  - `fixRequestId` string: The id of the fix request created (or reused) for the issue on that release

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