/bff/issue/merge

Sets parent_id on every source to the target's ULTIMATE ROOT — walking the target's own parent_id chain up to NULL — so repeated merges stay flat instead of building a tree. Any pre-existing children of the sources are re-parented to the same root in the same call. Each source is transitioned to the org-default done category (a specific done-row picked by an operator, e.g. Wontfix, is preserved). Rejects self-merge and merging into an issue that is already the target's own root. Never sends outbound mail — merging is a triage decision.

IssuepostBffIssueMerge

Parameters

JSON body

Request body

application/json

sourceIssueKeysstring[]Required

Issue keys to merge INTO the target. Every source is re-parented to the target's ultimate root and transitioned to the org-default done status. Minimum 1, maximum 100 per call — bulk-merging more than a handful at once usually indicates a triage mistake worth pausing on.

targetIssueKeystringRequired

Winning issue key. All sources are re-parented under this issue (or its ultimate root when the target itself has already been merged elsewhere).

ExampleBANDZ-100

Response schema

1 status code documented

200Success

success"true"Required

matchednumberRequired

Number of source issues folded into the root.

rootIssueKeystringRequired

The ultimate root the sources were re-parented under. Equals targetIssueKey when the target had no parent chain of its own.

targetIssueKeystringRequired

The target key as supplied by the caller.

mergedIssueKeysstring[]Required

Source keys that were folded (order preserved from the request).

Response example

application/json

{
  "success": true,
  "matched": 0,
  "rootIssueKey": "example_rootIssueKey",
  "targetIssueKey": "example_targetIssueKey",
  "mergedIssueKeys": [
    "string"
  ]
}

Request example

POST /bff/issue/merge

post

curl -X POST "https://api.bizkithub.com/bff/issue/merge" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "sourceIssueKeys": [
    "BANDZ-101"
  ],
  "targetIssueKey": "BANDZ-100"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key