Create a short link | Chat Bridge

Shortens an absolute http/https URL. Returns a 10-character identifier and the short link already built in short_link (without scheme: prepend https:// when you need a full URL). The link is valid for 3 days; any ttl sent in the body is ignored.

Authentication

x-api-keystring

App-Key of the account. Any channel is accepted.

AuthorizationBearer

OAuth 2.0 access token issued by POST /api/oauth/token. Takes precedence over x-api-key when both are sent.

Request

This endpoint expects an object.

urlstringRequiredformat: "uri"<=2048 characters

Absolute URL with http or https scheme, up to 2048 characters.

Response

Short link created.

identifierstringOptional

10-character code of the short link.

urlstringOptional

Destination URL as stored (normalized).

short_linkstringOptional

Short link without scheme, e.g. sl2.mx/aB3dE5gH7j.

Errors

400

Bad Request Error

401

Unauthorized Error

429

Too Many Requests Error