Update Short Link

Update basic information for an existing short link.

Endpoint

PUT /v2/external/client/short-links/{id}

Path Parameters

Parameter Type Required Description
id string Yes Short link ID or short URL

Request Body

{
  "id": "507f1f77bcf86cd799439011",
  "title": "Updated Link Title",
  "shortUrl": "updated-custom-url",
  "category": "business",
  "categoryTitle": "Business",
  "categoryValue": "website",
  "notes": "Internal notes about this link",
  "isActive": true
}

Parameters

Parameter Type Required Description
id string Yes Short link ID (must match path parameter)
title string No Updated title
shortUrl string No Updated short URL (max 100 characters, must be unique)
category string No Updated category identifier
categoryTitle string No Updated category display name
categoryValue string No Updated category value
notes string No Internal notes (max 1000 characters)
isActive boolean Yes Whether the link is active

Response

{
  "status": true,
  "message": "Short link updated successfully",
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "originalUrl": "https://example.com/very/long/url",
    "shortUrl": "updated-custom-url",
    "title": "Updated Link Title",
    "category": "business",
    "isActive": true,
    "updatedAt": "2024-01-15T11:00:00Z"
  }
}

Notes

  • Only links owned by the API key's user can be updated
  • Short URL changes must be unique across all users
  • All plan limits and validations apply