URL Management

Delete URL

Permanently remove a shortened URL from the database. This action is irreversible and will delete all associated analytics data.

Authentication: Required (JWT token or session cookie)

API Key: Required (must have urls:manage or admin:all scope)

Rate Limits: 60/min, 5000/day

Ownership: Can only delete URLs owned by your account

Important Consequences:

Alternative: Consider setting status to INACTIVE instead if you want to preserve the URL and its analytics for future reference.

DELETE

urls

{url_id}

Delete URL

curl --request DELETE \
  --url https://spoo.me/api/v1/urls/{url_id} \
  --header 'Authorization: Bearer <token>'

{
  "message": "URL deleted",
  "id": "<string>"
}

Authorization

string

header

required

API key in format: spoo_. Use in Authorization header as 'Bearer spoo_'

url_id

string

required

MongoDB ObjectId of the URL

URL deleted successfully

message

string

Example:

"URL deleted"

string

⌘I

Delete URL

curl --request DELETE \
  --url https://spoo.me/api/v1/urls/{url_id} \
  --header 'Authorization: Bearer <token>'

{
  "message": "URL deleted",
  "id": "<string>"
}