---
title: "POST /feedback_item/{feedbackItemId}/promote"
method: POST
path: "/feedback_item/{feedbackItemId}/promote"
tags: ["Feedback items"]
---

# POST /feedback_item/{feedbackItemId}/promote

`POST /feedback_item/{feedbackItemId}/promote`

Promote a feedback item into a new work item created under the given
parent (themes→epic, epics→story/bug/etc, leaf items→sub-task) and link
them atomically.

## Path parameters

- `feedbackItemId` string, required

## Request body

- PromoteFeedbackRequest
  - `parentItemId` string, required — ID of the existing work item to create the promoted item under.
  - `promotedItemType` string — Optional type for the new item when the parent is an epic (ignored for other parents — a theme yields an epic, a leaf item yields a sub-task). One of: story, bug, task, requirement (case-insensitive). Defaults to `story`. Typed as string (not a literal union) so an invalid value yields a single clean 422 instead of tsoa's noisy 4-way union mismatch.

## Response `200`

The feedback item is promoted to a new work item

- PromoteFeedbackResponse
  - `feedbackItemId` string, required
  - `createdItemId` string, required — ID of the newly created work item linked to the feedback item.
  - `shortId` string — ShortId of the new work item (e.g. `CRK-1234`).
  - `createdItemType` string — Type of the new work item, derived from the parent (theme→epic, epic→story/ bug/task/requirement, leaf→sub-task). Lets the caller confirm what was made.
  - `webUrl` string — Direct link to the new work item in the Craft.io app.

## Other responses

- `401` — No access to account
- `403` — Access denied
- `404` — No idea found
- `422` — Invalid item ID
- `500` — An error occurred while promoting the feedback item

---

[API](https://skmtc.net/craft/apis/craft-io-public-api.md) · [All operations](https://skmtc.net/craft/apis/craft-io-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/craft/craft-io-public-api/versions/2d001661c781/schema)