---
title: "PATCH /api/admin/classification-impact-areas/{id}"
method: PATCH
path: "/api/admin/classification-impact-areas/{id}"
tags: ["Administration/Classification Impact Areas"]
---

# PATCH /api/admin/classification-impact-areas/{id}

`PATCH /api/admin/classification-impact-areas/{id}`

## Request

- Base URL: `https://api.retraced.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.retraced.com/api/admin/classification-impact-areas/{id}`
- Auth: none declared

Edits a link's `impactAreaId`, `dataFieldId`, `relationType` and/or `description` (only the keys sent are written; null or an empty string clears `relationType`/`description`), stamped with the caller, and answers the link as stored. Moving it to another impact area or data field drops the cached classification views of the area it left and of the one it moved to. An empty body changes nothing. 404 `not_found` for an unknown id; 409 `impact_area_to_datafield_link_exists` when the move lands on a pair that is already linked (legacy answered 500); 400 for a null or empty `impactAreaId`/`dataFieldId`, which legacy stored as NULL. Answers `{ data, metadata }`; legacy answered the pre-edit row merged with the body.

## Path parameters

- `id` string, required

## Request body

- object
  - `dataFieldId` string
  - `impactAreaId` string
  - `relationType` string, nullable
  - `description` string, nullable

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required: True when the request succeeded.
  - `data` object, required
    - `id` string, required
    - `dataFieldId` string, nullable, required
    - `impactAreaId` string, nullable, required
    - `relationType` string, nullable, required
    - `description` string, nullable, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `409`: Default Response

## Changes

> 108 revisions in range; 2 not diffed.

- **2026-10-15** `e8ed55a66a25`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/retraced/apis/api-reference/changes/api/admin/classification-impact-areas/:id/patch.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) - [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/retraced/apis/api-reference/revisions/83309c4abd20?raw)
