---
title: "Unlink tests from a requirement"
method: DELETE
path: "/api/requirements/{id}/tests"
tags: ["Requirements"]
---

# Unlink tests from a requirement

`DELETE /api/requirements/{id}/tests`

## Request

- Base URL: `https://demo.supercheck.dev`
- URL: `https://demo.supercheck.dev/api/requirements/{id}/tests`
- Auth: HTTP bearer

Remove links between a requirement and tests. Requires `requirement:update`. Pass a single test with the `testId` query parameter, or several in a JSON body `{ "testIds": [...] }`. Unlinking a test that is not linked is a no-op.

## Query parameters

- `testId` string, uuid

## Request body

- RequirementTestIdsRequest
  - `testIds` string[], required

## Response `200`

Requirement with its updated links

- RequirementResponse
  - `requirement` Requirement: Requirement as returned by the detail, create, update and test-link endpoints.
    - `id` string, uuid
    - `title` string
    - `description` string, nullable
    - `priority` 'low' | 'medium' | 'high', nullable
    - `tags` string[]: Tag names.
    - `externalId` string, nullable
    - `externalUrl` string, nullable
    - `testIds` string[]
    - `coverage` RequirementCoverage
      - `status` 'covered' | 'failing' | 'missing'
      - `linkedTestCount` integer
      - `passedTestCount` integer
      - `failedTestCount` integer
      - `lastEvaluatedAt` string, date-time, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable

## Other responses

- `400`: Invalid request body or JSON
- `401`: Authentication required or token invalid
- `403`: Insufficient permissions
- `404`: Resource not found

## Changes

- **2026-10-25** `9d4e9599f8c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/supercheck-io/apis/supercheck-api/changes/api/requirements/:id/tests/delete.md)

---

[API](https://skmtc.dev/supercheck-io/apis/supercheck-api.md) - [All operations](https://skmtc.dev/supercheck-io/apis/supercheck-api/llms.txt) - [OpenAPI document](https://skmtc.dev/supercheck-io/apis/supercheck-api/revisions/7fa0162c07bd?raw)