Skip to main content
PATCH
https://api.linquid.io
/
links
/
{id}
Update Link
curl --request PATCH \
  --url https://api.linquid.io/links/{id} \
  --header 'Authorization: Bearer <token>'

Update Link

Update properties of an existing link.

Request

curl -X PATCH https://api.linquid.io/links/link_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Title",
    "enabled": false
  }'

Path Parameters

ParameterTypeDescription
idstringLink ID

Body Parameters

All fields are optional. Only include fields you want to update.
ParameterTypeDescription
destinationUrlstringTarget URL
titlestringDisplay name
descriptionstringDescription
enabledbooleanActive status
expiresAtstringISO 8601 expiration
clicksLimitnumberMax clicks
passwordstringPassword (null to remove)
campaignIdstringMove to campaign
deepLinkEnabledbooleanEnable deep links
deepLinkIosstringiOS deep link
deepLinkAndroidstringAndroid deep link
deepLinkFallbackUrlstringFallback URL
conversionTrackingbooleanEnable tracking
The shortCode cannot be changed after creation.

Response

{
  "success": true,
  "data": {
    "id": "link_abc123",
    "shortCode": "promo2024",
    "title": "Updated Title",
    "enabled": false,
    "updatedAt": "2024-01-15T16:00:00Z",
    "...": "..."
  }
}

Examples

curl -X PATCH https://api.linquid.io/links/link_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Change Destination

curl -X PATCH https://api.linquid.io/links/link_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destinationUrl": "https://new-destination.com"}'

Enable Deep Linking

curl -X PATCH https://api.linquid.io/links/link_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deepLinkEnabled": true,
    "deepLinkIos": "myapp://path",
    "deepLinkFallbackUrl": "https://fallback.com"
  }'

Remove Password

curl -X PATCH https://api.linquid.io/links/link_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"password": null}'