improved

Customize Bridge Link Expiration Times

You may now specify how long Bridge Links remain valid using a new ttlHours parameter.

What's Changed

When creating a bridge link through the POST /bind_api/v3/quoting/quote/{quote_id}/bridge_link endpoint, you can now set a custom expiration time between 1 and 48 hours. If you don't specify a duration or provide a value outside this range, the link will expire after 24 hours (the historically default behavior).

How to Use It

Simply include an additional ttlHours property in your bridge link creation request:

curl --request POST \
     --url https://app.joinroot.com/bind_api/v3/quoting/quote/{quote_id}/bridge_link \
     --header 'accept: application/json' \
     --header 'authorization: Bearer T0KEN' \
     --header 'content-type: application/json' \
     --data '
{
  "cancelUrl": "http://integration.url/unique_identifier/cancelled",
  "successUrl": "http://integration.url/unique_identifier/succeeded",
  "ttlHours": 1 // Link will expire in one hour
}
'