---
title: "Delete a public link"
method: DELETE
path: "/links/{linkId}"
tags: ["links"]
---

# Delete a public link

`DELETE /links/{linkId}`

## Request

- Base URL: `https://docs-api.formify.eu/v1`
- URL: `https://docs-api.formify.eu/v1/links/{linkId}`
- Auth: OAuth 2 (authorization code, authorization URL `https://docs-api.formify.eu/v1/oauth/authorize`, token URL `https://docs-api.formify.eu/v1/oauth/token`, scopes: `write`)

Deletes the link and everything that only it was using: its generated PDFs, thumbnails and any AI
assistant data.

### Disable it first
The link must already be disabled. Call `PUT /links/{linkId}/disable`, then delete. A live link that
is deleted would keep serving — deleting removes it from your listings but does not close the link
itself, and once it is gone there is no endpoint left to close it with. Deleting a link that is still
live is refused with `409`.

**Documents already produced by the link are not deleted** and remain fully accessible. A PDF still
used by one of them is left in place.

Disabling has already released the billed link instance, so deletion changes nothing about billing.

Owner only — note that disabling is not, so a colleague can switch a shared link off but only the
owner can delete it.

## Path parameters

- `linkId` string, uuid, required

## Query parameters

- `errorLanguage` 'en' | 'sv' | 'es'

## Response `204`

Public link deleted successfully. Empty body.

## Other responses

- `401`: Unauthorized - Missing or invalid access token.
- `403`: Forbidden - not the owner, or a required capability is missing.
- `404`: Public link not found
- `409`: Conflict - the link is still live. Disable it with `PUT /links/{linkId}/disable` first.
- `500`: Internal server error

---

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