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"]
  }'

const response = await fetch(
  'https://api.bouncy.ai/v1/links/my-slug',
  {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      destination: 'https://example.com/updated-page',
      title: 'Updated Title',
      tags: ['updated', 'marketing']
    })
  }
);

const result = await response.json();
console.log(result.message);

import requests

response = requests.put(
    'https://api.bouncy.ai/v1/links/my-slug',
    headers={
        'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'destination': 'https://example.com/updated-page',
        'title': 'Updated Title',
        'tags': ['updated', 'marketing']
    }
)

result = response.json()
print(result['message'])

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

{
  "error": "Not Found",
  "message": "Deeplink not found"
}

{
  "error": "Bad Request",
  "message": "The destination URL must be a valid HTTP or HTTPS URL",
  "field": "destination"
}

{
  "error": "Forbidden",
  "message": "You do not have permission to modify this deeplink"
}

​
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"]
  }'

const response = await fetch(
  'https://api.bouncy.ai/v1/links/my-slug',
  {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      destination: 'https://example.com/updated-page',
      title: 'Updated Title',
      tags: ['updated', 'marketing']
    })
  }
);

const result = await response.json();
console.log(result.message);

import requests

response = requests.put(
    'https://api.bouncy.ai/v1/links/my-slug',
    headers={
        'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'destination': 'https://example.com/updated-page',
        'title': 'Updated Title',
        'tags': ['updated', 'marketing']
    }
)

result = response.json()
print(result['message'])

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

{
  "error": "Not Found",
  "message": "Deeplink not found"
}

{
  "error": "Bad Request",
  "message": "The destination URL must be a valid HTTP or HTTPS URL",
  "field": "destination"
}

{
  "error": "Forbidden",
  "message": "You do not have permission to modify this deeplink"
}