Skip to main content
PUT
/
links
/
:id
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"url": "https://www.new-destination.com"}' \
-X PUT https://api.ayrshare.com/api/links/TkuWEy
{
    "status": "success",
    "id": "TkuWEy",
    "originalUrl": "https://www.new-destination.com",
    "shortUrl": "https://ayrs.io/TkuWEy",
    "created": "2023-07-17T15:20:51.118Z",
    "updated": "2024-01-10T12:30:00.000Z"
}
Update the destination URL of an existing short link. The short link ID is returned when you first create a short link via POST /links.
Social Media Preview Caching: Social media platforms cache Open Graph preview cards from the original destination URL. After updating a short link, the preview card shown on social platforms may not match the new destination until the cache expires.

Header Parameters

Path Parameters

id
string
required
The short link ID returned from POST /links (e.g., “TkuWEy”).

Body Parameters

url
string
required
The new destination URL. Must be a valid URL starting with https://
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"url": "https://www.new-destination.com"}' \
-X PUT https://api.ayrshare.com/api/links/TkuWEy
{
    "status": "success",
    "id": "TkuWEy",
    "originalUrl": "https://www.new-destination.com",
    "shortUrl": "https://ayrs.io/TkuWEy",
    "created": "2023-07-17T15:20:51.118Z",
    "updated": "2024-01-10T12:30:00.000Z"
}