Update a Dynamic Link

put

https://api.linkhive.tech/api/dynamicLinks/{projectId}/{dynamicLinkId}

Updates the details of an existing dynamic link within a specified project. You can modify fields such as the target URL, UTM parameters, social media metadata, and other optional properties.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

projectId

string

required

dynamicLinkId

string

required

Body Params

platforms

array of objects

required

An array of platform IDs to which the dynamic link belongs. This field must be provided when updating a dynamic link to specify the target platforms (e.g., iOS, Android, Web).

platforms*

dynamicLinkPath

string

Optional path that will be appended to the final redirect link. For example, if link is https://yourwebsite.com/page, and dynamicLinkPath is promo/user123, then the final redirect target will be https://yourwebsite.com/page/promo/user123.

linkMetadata

object

Optional metadata map. Contains key-value pairs (both strings) to pass along with the dynamic link, for tracking or client-side usage.

utmSource

string

Identifies the source of the traffic (e.g., google, newsletter, facebook).

utmMedium

string

Identifies the marketing medium (e.g., email, cpc, banner).

utmCampaign

string

Identifies the campaign name or ID (e.g., summer_sale, launch2025).

utmContent

string

Differentiates similar content or links (e.g., header-link, footer-link).

utmTerm

string

Identifies search keywords or terms (used mostly in paid search).

socialMediaTitle

string

The title to display in social media previews (used in Open Graph og:title).

socialMediaDescription

string

The description shown in the preview card (used in Open Graph og:description).

socialMediaImageUrl

string

URL to the image used in the preview (Open Graph og:image). Should be a fully qualified URL.

socialMediaType

string

Type of content, such as article, website, etc. (Open Graph og:type).

skipPreviewPage

boolean

Defaults to true

If true, skips the preview/interstitial page and forces the link to open directly in the app (deep link behavior).

generateQrCode

boolean

Defaults to false

If true, generates a QR code for the dynamic link and includes it in the response.

Response

200