Apps

Set an app's default link domain

Chooses the default domain for the app's new links: aplnk.to (legacy apps only), the app's own subdomain, or a live custom domain. Reversible. Existing links keep their addresses, and no redirect is created. Needs an API key that has a creator. Send the link_handle and default_link_domain you last read, so a change made meanwhile is never overwritten. A request already at the requested default returns the current app without a change.

put/apps/{id}/link-domain

Request

  • Base URL: https://api.warplink.app/v1
  • URL: https://api.warplink.app/v1/apps/{id}/link-domain
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Request body

domainstring required

The hostname new links use by default. One of allowed_link_domains on the app.

expected_link_handlestring required

The app's link_handle as you last read it.

expected_default_link_domainstring required

The app's default_link_domain as you last read it.

confirmboolean

Must be true for a change. Without it a change is refused with 400 VALIDATION_ERROR.

Response

The app with its new default

idstring uuid
org_idstring uuid
namestring
ios_bundle_idstring nullable
ios_team_idstring nullable
ios_app_store_idstring nullable
ios_app_store_urlstring uri nullable
ios_universal_link_pathsstring[] nullable
android_package_namestring nullable
android_sha256_fingerprintsstring[] nullable
android_play_store_urlstring uri nullable
android_app_links_pathsstring[] nullable
icon_urlstring uri nullable
icon_source'auto' | 'manual'
probabilistic_matchingboolean

False means routing-only mode: the server no longer matches installs by probabilistic match or raw device signals for this app. Deep links keep working, and deferred links and attribution use only deterministic signals (the Android Play Install Referrer click id, and a device that already has an install). Defaults to true.

link_handlestring

The lowercase subdomain label for this app's links, for example acme in acme.aplnk.to. Every app has one.

link_domainstring

The full host derived from link_handle, for example acme.aplnk.to.

legacy_apex_enabledboolean

True for an app that existed when app subdomains launched. Its links on aplnk.to keep working and aplnk.to keeps listing the app for good.

default_link_domainstring

The domain a new link gets when a create request names none: the saved default, or link_domain when none is saved. Change it with PUT /v1/apps/{id}/link-domain. It never changes a link that already exists.

default_link_domain_availableboolean

False when the saved default is a custom domain that is no longer live. A link created with no domain then gets 409 DEFAULT_DOMAIN_UNAVAILABLE until you choose a domain or a new default.

allowed_link_domainsstring[]

The hostnames a new link for this app may use: the default first when it is available, then aplnk.to (legacy apps only), link_domain and the org's live custom domains.

previous_link_handlestring nullable

The app's old subdomain label while a rename period is open. null otherwise.

previous_link_domainstring nullable

The full old host while a rename period is open, for example oldname.aplnk.to. It keeps opening the app.

rename_period_ends_atstring date-time nullable

The date shown for the open rename period. It is not a deadline and not a promise to move links that day. If links on the old subdomain later move to the new one, their old URLs redirect. null when no period is open.

rename_period_extensionsinteger

How many times the open rename period was extended by 1 month. At most 2.

created_atstring date-time
updated_atstring date-time

Changes

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