---
title: "DELETE tracked link"
description: "Server-only, installation-scoped tracked links. TEST and LIVE come from the credential. Destinations must use HTTPS on an origin registered to the installation. No credentials, authentication links, unsubscribe URLs or personal data should be included. Click observations may include scanners and never prove consent, human activity, payment or redemption."
---

`DELETE /v1/developer/collections/{collection}/tracked-links/{linkId}`

**Operation ID:** `revokeDeveloperTrackedLink`

Server-only, installation-scoped tracked links. TEST and LIVE come from the credential. Destinations must use HTTPS on an origin registered to the installation. No credentials, authentication links, unsubscribe URLs or personal data should be included. Click observations may include scanners and never prove consent, human activity, payment or redemption.

## Contract status

| Field | Value |
| --- | --- |
| Maturity | `preview` |
| Required capability | `links.write` |
| Freshness class | `authenticated-state` |
| Quota cost | `1` |

All operations require a Kismet Developer Bearer credential. Collection and resource authority is resolved from the credential's installation grants; identifiers in the URL never grant access.

## Request parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `collection` | path | string | yes |  |
| `linkId` | path | string | yes |  |

## Request body

This operation has no JSON request body.

## cURL

Set `KISMET_API_ORIGIN=https://api.ksmt.app` and configure `KISMET_DEVELOPER_API_KEY` in your environment. Run server-credential requests from your backend, not browser code.

```sh
curl --request DELETE \
  "$KISMET_API_ORIGIN/v1/developer/collections/example-collection/tracked-links/11111111-1111-4111-8111-111111111111" \
  --header "Authorization: Bearer $KISMET_DEVELOPER_API_KEY" \
  --header "Accept: application/json"
```

## Responses

| Status | Meaning |
| --- | --- |
| 200 | Success. |
| 400 | Invalid request parameters or body. |
| 401 | Missing, invalid, expired, or inappropriate credential/session. |
| 403 | Credential lacks the required grant/capability, or an origin/CSRF check failed. |
| 404 | The authorized resource was not found. |
| 409 | Request conflicts with the installation environment or current state. |
| 429 | Rate limit or quota exceeded; inspect response metadata before retrying. |
| 500 | See the RFC problem response. |
| 503 | A required Kismet dependency is temporarily unavailable. |

### 200 response schema

Content type: `application/json`. Required fields, nullable values, and nested structures are defined below.

<details>
<summary>View complete response schema</summary>

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "status": {
      "type": "string",
      "enum": [
        "revoked"
      ]
    }
  },
  "required": [
    "id",
    "status"
  ],
  "additionalProperties": false
}
```

</details>

## Machine-readable sources

- [This page as Markdown](/api/reference/revoke-developer-tracked-link.md)
- [Developer API OpenAPI v0.7.50](/openapi.json)