Links

Delete a link

Permanently deletes the link. This is not reversible: it also removes the link's click history and frees the slug for reuse. To pause a link instead while keeping its data, send a PATCH with is_active set to false.

delete/links/{id}

Request

Base URL: https://api.warplink.app/v1
URL: https://api.warplink.app/v1/links/{id}
Auth: HTTP bearer

Path parameters

idstring uuid required

Response

Deleted link

idstring uuid

short_urlstring

slugstring

namestring nullable

The link's own name in the dashboard. Null shows the slug.

domainstring

destination_urlstring uri

ios_urlstring uri nullable

ios_fallback_urlstring uri nullable

android_urlstring uri nullable

android_fallback_urlstring uri nullable

og_titlestring nullable

og_descriptionstring nullable

og_image_urlstring uri nullable

app_idstring uuid nullable

utm_sourcestring nullable

Added to the redirect URL as utm_source when no higher source supplies one. Order for utm_source: an injected utm_source in "always" mode wins; otherwise the visitor's own utm_source when parameters.forwarding passes it, then a utm_source already in the destination URL, then an injected utm_source in "default" mode (this field is then not used), then this field. Applies to http and https URLs only; not to apps.apple.com, itunes.apple.com, play.google.com, apps.microsoft.com or custom-scheme URLs.

utm_mediumstring nullable

Added to the redirect URL as utm_medium when no higher source supplies one. Order for utm_medium: an injected utm_medium in "always" mode wins; otherwise the visitor's own utm_medium when parameters.forwarding passes it, then a utm_medium already in the destination URL, then an injected utm_medium in "default" mode (this field is then not used), then this field. Applies to http and https URLs only; not to apps.apple.com, itunes.apple.com, play.google.com, apps.microsoft.com or custom-scheme URLs.

utm_campaignstring nullable

Added to the redirect URL as utm_campaign when no higher source supplies one. Order for utm_campaign: an injected utm_campaign in "always" mode wins; otherwise the visitor's own utm_campaign when parameters.forwarding passes it, then a utm_campaign already in the destination URL, then an injected utm_campaign in "default" mode (this field is then not used), then this field. Applies to http and https URLs only; not to apps.apple.com, itunes.apple.com, play.google.com, apps.microsoft.com or custom-scheme URLs.

match_window_hoursinteger nullable

expires_atstring date-time nullable

is_activeboolean

tagsstring[]

created_atstring date-time

updated_atstring date-time

Example response

{
  "short_url": "https://aplnk.to/abc123",
  "slug": "abc123",
  "name": "Summer sale",
  "domain": "aplnk.to"
}

Changes

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