---
title: "Revoke an evidence link"
method: POST
path: "/stats/evidence/links/{id}/revoke"
tags: ["Stats"]
---

# Revoke an evidence link

`POST /stats/evidence/links/{id}/revoke`

## Request

- Base URL: `https://api.nippy.host`
- URL: `https://api.nippy.host/stats/evidence/links/{id}/revoke`
- Auth: `bearer` (a scheme the document does not define)

Admin-only. The link stops working at once.

## Path parameters

- `id` string, required

## Response `200`

- APIEvidenceLink
  - `id` string, required
  - `label` string, required
  - `state` 'active' | 'expired' | 'revoked', required
  - `expiresAt` string, required
  - `revokedAt` string, nullable, required
  - `createdByName` string, nullable, required
  - `createdAt` string, required
  - `accessCount` number, required: Requests made with the link.
  - `lastAccessAt` string, nullable, required

## Other responses

- `403`: Admin access required
- `404`: Link not found
- `409`: The link is already revoked

---

[API](https://skmtc.dev/nippy/apis/nippy-backend-api.md) · [All operations](https://skmtc.dev/nippy/apis/nippy-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nippy/apis/nippy-backend-api/revisions/7ab23f040a55?raw)