Skip to main content
PUT
/
v1
/
links
/
{identifier}
curl -X PUT https://api.bouncy.ai/v1/links/my-slug \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "https://example.com/updated-page",
    "title": "Updated Title",
    "tags": ["updated", "marketing"]
  }'

{
  "success": true,
  "id": "my-slug",
  "message": "Link updated successfully",
  "updatedFields": ["destination", "title", "tags"]
}

​
Request

​
Headers

​
Content-Type
string
required
Must be application/json

​
Path Parameters

​
identifier
string
required
The link’s slug (e.g., my-link) or system domain composite (e.g., mybouncy.link__my-link).Use the slug field returned by GET /v1/links.

​
Body

​
destination
string
New destination URL where the short link should redirect. Must be a valid HTTP or HTTPS URL.Example: https://example.com/new-page
​
title
string
Updated title for SEO and social media sharingExample: Updated Summer Sale 2026
​
description
string
Updated description for SEO and social media cardsExample: Now 60% off everything!
​
tags
array
Updated array of tagsExample: ["marketing", "summer", "60-percent-off"]
​
googleTags
object
Google Analytics tracking configuration
​
metaPixel
object
Meta Pixel tracking configuration
​
seo
object
Full SEO metadata object override (ignored if title or description are also provided)
​
behavior
string
Redirect behavior. One of: conservative, aggressive, basic, non-meta, experimental, experimental2
​
geoRules
array
Array of geographic filtering rules
​
languageRules
array
Array of language-based filtering rules
​
alternateBackUrl
string
Traffic recovery URL for when the primary destination is unavailable
You cannot update the slug or domain after creation. Create a new link if you need a different slug.

​
Response

​
success
boolean
Whether the operation succeeded
​
id
string
Unique identifier for the link
​
message
string
Success message
​
updatedFields
array
List of fields that were updated
curl -X PUT https://api.bouncy.ai/v1/links/my-slug \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "https://example.com/updated-page",
    "title": "Updated Title",
    "tags": ["updated", "marketing"]
  }'

{
  "success": true,
  "id": "my-slug",
  "message": "Link updated successfully",
  "updatedFields": ["destination", "title", "tags"]
}