---
title: "Revoke a client report link — whoever holds it sees nothing from the next request"
method: DELETE
path: "/api/v1/report-links/{id}"
tags: ["reports"]
---

# Revoke a client report link — whoever holds it sees nothing from the next request

`DELETE /api/v1/report-links/{id}`

## Request

- Base URL: `https://app.utmkit.co`
- URL: `https://app.utmkit.co/api/v1/report-links/{id}`
- Auth: HTTP bearer

Requires a token with the `reports:write` permission.

## Path parameters

- `id` integer, required

## Response `200`

Report link

- ReportLink: A client report link (#418). Its URL is returned once, at creation, and is never stored.
  - `created_at` string, date-time
  - `host` string: The domain the report is served on
  - `id` integer
  - `revoked_at` string, date-time, nullable
  - `state` 'live' | 'revoked'

## Other responses

- `403`: Error
- `404`: Error

---

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