Link Management

Delete links by date interval

Delete links of a domain within a created-at date interval.

Provide any combination of bounds (at least one is required):

  • createdAfter / createdBefore: Unix timestamps in milliseconds
  • days: relative upper bound (delete links older than N days)

Optionally restrict deletion to links whose conditionalColumn matches conditionalMatch. Deletion runs asynchronously.

delete/links

Request

  • Base URL: https://api.short.io
  • URL: https://api.short.io/links
  • Auth: API key in header Authorization

Request body

daysinteger

Delete links older than this many days (relative upper bound)

createdBeforeinteger

Delete links created before this Unix timestamp in milliseconds (upper bound)

createdAfterinteger

Delete links created after this Unix timestamp in milliseconds (lower bound)

domainIdstring required

Domain ID whose links to prune

conditionalMatchstring

Substring the conditional column must contain

Example request

{
  "days": 180,
  "createdBefore": 1700000000000,
  "createdAfter": 1690000000000,
  "domainId": "12345",
  "conditionalMatch": "expired"
}

Response

Default Response

successboolean required

Whether the operation succeeded

errorstring

Error message when operation failed

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.