---
title: "POST /experimental/launch-runs/{id}/links"
method: POST
path: "/experimental/launch-runs/{id}/links"
tags: ["Launch Runs"]
---

# POST /experimental/launch-runs/{id}/links

`POST /experimental/launch-runs/{id}/links`

## Request

- Base URL: `https://api.tessl.io`
- URL: `https://api.tessl.io/experimental/launch-runs/{id}/links`
- Auth: none declared

Attaches an append-only external link to a launch run.

## Path parameters

- `id` string, uuid, required

## Headers

- `Authorization` string

## Request body

- object
  - `rel` union, required
    - 'produced'
    - 'references'
  - `linkType` union, required
    - 'github_pr'
    - 'github_issue'
    - 'linear_issue'
  - `value` string, required
  - `displayTitle` string

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, uuid, required
    - `type` 'launch-run-link', required
    - `attributes` object, required
      - `rel` union, required
        - 'produced'
        - 'references'
      - `linkType` union, required
        - 'github_pr'
        - 'github_issue'
        - 'linear_issue'
      - `value` string, required
      - `displayLabel` string
      - `displayTitle` string
      - `createdAt` string, date-time, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-10-16** `011f27f8354e`: 2 info
  - added `subschema #2` to the `linkType` request property `anyOf` list
  - added `subschema #2` to the `data/attributes/linkType` response property `anyOf` list for the response status `200`
- **2026-09-30** `be5a1bbf9bfa`: 3 warning
  - removed the request property `displayLabel`
  - removed the request property `displayUrl`
  - removed the optional property `data/attributes/displayUrl` from the response with the `200` status
- **2026-09-28** `68be470e794a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/launch-runs/:id/links/post.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) · [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tessl/apis/tessl-api/revisions/7386f1e6295b?raw)