---
title: "Link a shared test suite to one or more specifications."
method: POST
path: "/testsuite/linkShared"
tags: ["Test suites"]
---

# Link a shared test suite to one or more specifications.

`POST /testsuite/linkShared`

## Request body

- TestSuiteLinkRequest — Request to link a shared test suite with one or more specifications.
  - `testSuite` string, required — The identifier of the shared test suite.
  - `specifications` TestSuiteLinkRequestSpecification[], required — The list of specifications to link the test suite to.
    - `specification` string, required — The API key identifying the specification to link the test suite to.
    - `update` boolean — Whether or not to update the specification's actor metadata based on the test suite.

## Response `200`

Test suite successfully linked.

- TestSuiteLinkResponseSpecification[] — Response for the linking of a shared test suite with one or more specifications.
  - `specification` string, required — The API key identifying the specification.
  - `linked` boolean, required — Whether or not the test suite was linked to the specification.
  - `message` string — A message detailing why the specification was not linked (if linking didn't take place).
  - `actors` TestSuiteUploadActorKeys[] — The information for the actors linked to the specification.
    - `name` string, required — The name of the actor.
    - `identifier` string, required — The API key of the actor.

## Other responses

- `429` — Call rate limit threshold exceeded for this operation.
- `default` — The received request was invalid.

## Changes

- **2026-03-19** `7637660a4a6b` — 1 info
  - added the non-success response with the status `429`
- **2024-08-26** `47017afa7060` — 1 info
  - removed the non-success response with the status `400`
- **2024-04-12** `d1203e014562` — 1 info
  - added the optional property `items/actors` to the response with the `200` status
- **2023-03-03** `9834e827d363` — 1 info
  - endpoint added
- **2022-06-27** `06f633c06bcd` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/changes/testsuite/linkShared/post.md)

---

[API](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api.md) · [All operations](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ec-jrc/interoperability-test-bed-rest-api/revisions/433b3c0ae6d4/schema)