Skip to content

API reference

Delete a link

Permanently delete a short link in your personal workspace by its alias.

DELETEhttps://ishortn.ink/api/v1/links/{alias}

Deletes one short link in your personal workspace. The link stops redirecting straight away. This can't be undone.

On a platform domain, the alias of a deleted link can't be used again, so old printed codes and shared URLs never start pointing somewhere new.

Restricted accounts can still delete links.

Request

ParameterInTypeRequiredDescription
aliaspathstringYesThe link's alias, such as launch-day.
domainquerystringNoThe link's domain. Defaults to your default domain, or isht.app. See Domains.
curl "https://ishortn.ink/api/v1/links/launch-day?domain=isht.app" \
  -X DELETE \
  -H "x-api-key: YOUR_API_KEY"

Response

204 No Content with an empty body.

Errors

Error bodies use the standard error shape, except the plan-gated 403.

StatusCodeMessageCause
401unauthorizedInvalid or missing API keySee Authentication.
403{"error": "API access requires Pro", "upgrade_url": "https://ishortn.ink/pricing"} (whole body)The key's account isn't on Pro or Ultra and its notice period has ended. See API access by plan.
403forbiddenDomain not available for this API keydomain isn't a platform domain or an active custom domain in your personal workspace.
404not_foundLink not foundNo link with that alias on that domain in your personal workspace.
429rate_limitedRate limit exceeded. Retry in N seconds.See Rate limits.
500internal_errorFailed to delete link due to a server errorAn unexpected server error. Retry later.

Something missing or unclear? Email support@ishortn.ink.