---
title: "Deleting a Link"
method: DELETE
path: "/v1/projects/{projectId}/forms/{xmlFormId}/public-links/{linkId}"
tags: ["Public Access Links"]
---

# Deleting a Link

`DELETE /v1/projects/{projectId}/forms/{xmlFormId}/public-links/{linkId}`

You can fully delete a link by issuing `DELETE` to its resource. This will remove the Link from the system entirely. If instead you wish to revoke the Link's access to prevent future submission without removing its record entirely, you can issue [`DELETE /sessions/:token`](/central-api-authentication/#logging-out-current-session).

## Path parameters

- `projectId` number, required
- `xmlFormId` string, required
- `linkId` integer, required

## Response `200`

OK

- Success
  - `success` boolean, required

## Changes

- **2025-12-20** `022694254f0d` — 1 info
  - api operation id `Deleting a Link` removed and replaced with `deleteLink`
- **2025-10-27** `b11b54eea487` — 1 info
  - removed the non-success response with the status `403`
- **2025-03-13** `e8c2858fd4eb` — 2 info
  - api operation id `deleteLink` removed and replaced with `Deleting a Link`
  - added the non-success response with the status `403`

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/v1/projects/:projectId/forms/:xmlFormId/public-links/:linkId/delete.md)

---

[API](https://skmtc.dev/getodk/apis/odk-central-api.md) · [All operations](https://skmtc.dev/getodk/apis/odk-central-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getodk/odk-central-api/revisions/d4f5ba77f644/schema)