---
title: "Unlink Gl Collision Link"
method: POST
path: "/companies/{company_id}/gl/collision-links/{link_id}/unlink"
tags: ["gl-subledgers"]
---

# Unlink Gl Collision Link

`POST /companies/{company_id}/gl/collision-links/{link_id}/unlink`

## Request

- Base URL: `https://app.zeno-works.ch` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zeno-works.ch/companies/{company_id}/gl/collision-links/{link_id}/unlink`
- Auth: none declared

Withdraw an invoice-number collision so its document can be booked — accountant.

ZCT-259. The collision row was terminal: it excluded the incoming document from the AI
coding queue permanently *and* manual coding refused it on the document-number
pre-check, so a genuinely different supplier invoice could not be booked by any route.
Withdrawing the link returns it to both, and the linker will not re-create it.

The payable is not touched — no status change, no ledger write. **409** when the link
is already withdrawn, or when it is any tier other than an advisory ``collision``
(every other tier records that the document is already in the ledger, so releasing it
would book the same liability twice). **404** for an unknown or other-tenant id.

## Path parameters

- `company_id` string, required
- `link_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- CollisionLinkUnlinkRequest: Why this collision was withdrawn — free text, stored on the link row (ZCT-259). Capped because it is caller-supplied text written verbatim into an unbounded ``Text`` column that an audit surface renders.
  - `reason` string, nullable

## Response `200`

Successful Response

- CollisionLinkUnlinkResult: The withdrawn link (ZCT-259). ``item_id`` is the document now released back to the coding queue and to manual coding; ``open_item_id`` is the payable it was filed against, which is left completely untouched.
  - `link_id` string, required
  - `item_id` string, nullable
  - `open_item_id` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zeno-works/apis/zeno-api.md) · [All operations](https://skmtc.dev/zeno-works/apis/zeno-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeno-works/apis/zeno-api/revisions/1eb93dde146c?raw)