DELETE/api/v6/urlshortener/links/{domain}/{code}

Delete a short link

Deletes the link and its analytics. The operation cannot be undone.

Scope

API key with the urlshortener service enabled

Usage limit

35 requests per second

A hard delete: the link and all of its analytics (daily, hourly and per-dimension visits) are removed in the same transaction. There is no way to recover it; if you need to keep the numbers, export them first with the statistics endpoint.

Path parameters

domain

stringrequired

Domain of the link.

code

stringrequired

Short code or alias (lowercase).

Responses

200

Link deleted.

{
  "success": true,
  "data": { "deleted": "a1b2c3d", "domain": "go.acme.co" },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-06-01T18:30:00+00:00",
    "responseTimeMs": 3
  }
}

401

Invalid or missing credentials.

404

No link with that domain and code.

429

Request limit exceeded.

Possible errors

Codes this endpoint can return in error.code. The full detail lives in the catalog.

401AUTH_REQUIREDNo Bearer token was sent, and every call requires one.401AUTH_INVALID_KEYThe API key is not recognized: wrong format, revoked or expired.401AUTH_SERVICE_NOT_ALLOWEDThe key is not allowed to use the service behind this endpoint.403ACCOUNT_READ_ONLYRead-only mode: only GET, HEAD and OPTIONS pass.404LINK_NOT_FOUNDNo link with that domain and code.429RATE_TPS_EXCEEDEDYou exceeded your organization quota for this endpoint.

See the full catalog

Scope and limits

Path parameters

Responses

Possible errors