Update Link

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

PUT

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

string

required

Must be application/json

Path Parameters

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

string

New destination URL where the short link should redirect. Must be a valid HTTP or HTTPS URL.Example: https://example.com/new-page

string

Updated title for SEO and social media sharingExample: Updated Summer Sale 2026

string

Updated description for SEO and social media cardsExample: Now 60% off everything!

array

Updated array of tagsExample: ["marketing", "summer", "60-percent-off"]

object

Google Analytics tracking configuration

object

Meta Pixel tracking configuration

object

Full SEO metadata object override (ignored if title or description are also provided)

string

Redirect behavior. One of: conservative, aggressive, basic, non-meta, experimental, experimental2

array

Array of geographic filtering rules. Rules are evaluated in order and the first matching rule wins. Visitors who match no rule are redirected to the main destination.Each rule is an object with:

countries (array) - ISO 3166-1 alpha-2 codes (e.g., US, GB) or full country names
presetId (string) - ID of a saved geo preset, as returned by GET /v1/geo-presets. Use this in place of countries: the server fills the rule’s countries from the preset’s saved country list when the link is saved. An unknown presetId returns a 400 error
cities (array) - City names, matched as case-insensitive substrings. Can be combined with either countries or presetId
redirectUrl (string) - Destination URL for visitors matching this rule. Always required, including when the rule uses presetId

Preset countries are copied into the rule once, at save time. Editing the preset later does not change links it was already applied to.Example:

[
  {
    "countries": ["US", "GB"],
    "cities": ["Manchester"],
    "redirectUrl": "https://example.com/uk-us-landing"
  },
  {
    "presetId": "a1B2c3D4e5F6g7H8",
    "redirectUrl": "https://example.com/preset-landing"
  }
]

array

Array of language-based filtering rules

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

boolean

Whether the operation succeeded

string

Unique identifier for the link

string

Success message

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

Links

Geo Presets

Analytics

Groups

Domains

Websites

Account

Request

Headers

Path Parameters

Body

Response

​Request

​Headers

​Path Parameters

​Body

​Response

Request

Headers

Path Parameters

Body

Response