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
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
alias | path | string | Yes | The link's alias, such as launch-day. |
domain | query | string | No | The 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.
| Status | Code | Message | Cause |
|---|---|---|---|
401 | unauthorized | Invalid or missing API key | See 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. | |
403 | forbidden | Domain not available for this API key | domain isn't a platform domain or an active custom domain in your personal workspace. |
404 | not_found | Link not found | No link with that alias on that domain in your personal workspace. |
429 | rate_limited | Rate limit exceeded. Retry in N seconds. | See Rate limits. |
500 | internal_error | Failed to delete link due to a server error | An unexpected server error. Retry later. |
Something missing or unclear? Email support@ishortn.ink.