---
title: "Update external issues for runs"
method: POST
path: "/run/{code}/external-issue"
tags: ["runs"]
---

# Update external issues for runs

`POST /run/{code}/external-issue`

This method allows you to update links between test runs and external issues (such as Jira tickets).

You can use this endpoint to:
- Link test runs to external issues by providing the external issue identifier (e.g., "PROJ-1234")
- Update existing links by providing a new external issue identifier
- Remove existing links by setting the external_issue field to null

**Important**: Each test run can have only one link with an external issue. If a test run already has an external issue link, providing a new external_issue value will replace the existing link.

The endpoint supports both Jira Cloud and Jira Server integrations. Each request can update multiple test run links in a single operation.

## Path parameters

- `code` string, required

## Request body

- object
  - `type` 'jira-cloud' | 'jira-server', required
  - `links` object[], required — Array of external issue links. Each test run (run_id) can have only one external issue link.
    - `run_id` integer, required
    - `external_issue` string, nullable — An external issue identifier, e.g. "PROJ-1234". Or null if you want to remove the link.

## Response `200`

OK.

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not Found.
- `429` — Too Many Requests.

---

[API](https://skmtc.dev/qase/apis/qase-io-testops-api-v1.md) · [All operations](https://skmtc.dev/qase/apis/qase-io-testops-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qase/qase-io-testops-api-v1/revisions/12ddc644fac5/schema)