---
title: "Archive a shared dashboard link"
method: DELETE
path: "/shared-dashboards/{share_uuid}"
tags: ["Shared Dashboards"]
---

# Archive a shared dashboard link

`DELETE /shared-dashboards/{share_uuid}`

Archive one share link. The uuid stops resolving immediately, so anyone holding the URL loses access — this is the revoke button.

Archiving frees the shop to create a new link, which gets a fresh uuid and a fresh password rather than reviving the archived one's settings. Use `PATCH ... {status: inactive}` instead if you only want to pause a link you intend to bring back.

Returns 404 if the link does not exist or belongs to a shop this key does not cover. Requires `read_write` scope.

## Path parameters

- `share_uuid` string, required — Share link UUID.

## Headers

- `Idempotency-Key` string, nullable

## Response `200`

Successful Response

- SharedDashboardDeleteResponse — Result of archiving a share link.
  - `success` boolean, required
  - `uuid` string, required
  - `message` string, required

## Other responses

- `400` — Validation error, or a missing/oversized Idempotency-Key.
- `403` — API key lacks `read_write` scope (`WRITE_NOT_PERMITTED`).
- `404` — Resource does not exist, or belongs to another shop.
- `409` — Idempotency conflict, or the resource already exists.
- `422` — Validation Error
- `429` — Write-tier rate limit (10/min, 50/hour, 100/day) exceeded.

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/5eefff009b5b/schema)