#The Link object

Core resource that ties a shortlink or QR entrypoint to its workflow, destination, and analytics metadata, letting Linkbreakers serve dynamic experiences while tracking scans for a workspace.

createdAt

string (date-time)

When the link was created.

customDomain

object

Captures a branded hostname that Linkbreakers provisions for a workspace so scans and shortlinks resolve under the customer's domain, including verification and certificate lifecycle state.

customDomainId

string

The ID of the custom domain (UUID). This is the custom domain that is used to access the link. If not defined, the link will be accessed using the default domain.

directoryId

string

The ID of the directory this link belongs to (UUID). If not set, the link is at the root level (not in any directory).

entrypoint

string

The entrypoint URL This is the URL that is available to be redirected to the destination.

eventCount

string (int64)

The number of time the link has been scanned. This number isn't refreshed instantly but will update itself within a few seconds.

expiredDestination

string

Where visitors are sent once the link has expired. Empty serves the built-in expired page instead.

expiresAt

string (date-time)

When the link stops resolving. Empty means it never expires. Must be in the future. Once it passes the link is removed from the workspace and only the expired destination is served.

fallbackDestination

string

The fallback destination URL to use when workflow steps are broken

string

The unique identifier of the link (UUID)

metadata

object

A map of string key-value pairs. All values must be strings. Nested objects or arrays are not supported. Maximum of 50 keys.

name

string

The name of the link

pageTheme

object

Page theme configuration

pageThemeId

string

The ID of the page theme for this link (UUID).

pageThemeTemplateId

string

The page theme template this link's styling was applied from (UUID). Empty when the theme was styled by hand rather than taken from a template. Set when a template is applied, and unchanged by later edits, so it records where the look came from rather than what it is now.

purpose

string

What the user is trying to achieve with this link, in one or two sentences.

qrcodeDesign

object

Captures the visual recipe Linkbreakers uses when rendering downloadable QR codes, including colors, shapes, export options, and center media. QR Code Designs are the visual representation of a link. They can be attached to QR Code Templates for reusability. They can only be attached to one record at a time.

qrcodeDesignId

string

The ID of the link design (UUID). This is the ID of the design that is used to generate the QR Code. If not defined, the design from the QR Code template will be used.

qrcodePendingUpdateSince

string (date-time)

When the link is pending QR Code update. This happens when the QR Code Design is updated and the QR Code image is still being processed.

qrcodeSignedUrl

string

The signed URL for the QR Code image. This URL eventually expires.

qrcodeTemplateId

string

The ID of the design template (UUID). This is the template that is used to generate the first QR Code Design assigned to the link. If not defined, a default QR Code Design will be generated.

shortlink

string

The short link for the link. This is the path segment that is attached to the URL. It can be defined by the client or generated by the system but is never null. It is unique within a custom domain or Linkbreakers default domain.

tags

array<object>

The tags associated with the link.

updatedAt

string (date-time)

When the link was last updated.

workspaceId

string

The workspace ID the link belongs to (UUID)

Learn more

Learn more about links in Linkbreakers

Example object

{
  "createdAt": "2026-10-05T09:55:18.784Z",
  "customDomain": {
    "activatedAt": "2026-10-05T09:55:18.784Z",
    "certificateExpiresAt": "2026-10-05T09:55:18.784Z",
    "cloudflareHostnameStatus": "active",
    "cloudflareSslStatus": "pending_validation",
    "createdAt": "2026-10-05T09:55:18.784Z",
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "lastCheckedAt": "2026-10-05T09:55:18.784Z",
    "lastError": "string",
    "name": "example.com",
    "rootDestination": "https://example.com",
    "status": "STATUS_ACTIVE",
    "updatedAt": "2026-10-05T09:55:18.784Z",
    "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
  },
  "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
  "entrypoint": "https://linkbreak.ing/4BnH-R19p",
  "eventCount": 128,
  "expiredDestination": "https://example.com/campaign-over",
  "expiresAt": "2026-12-31T23:59:59Z",
  "fallbackDestination": "https://brand.example.com/fallback",
  "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
  "metadata": {},
  "name": "string",
  "pageTheme": {
    "badgeEnabled": false,
    "badgeIconColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "badgeId": "string",
    "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
    "bodyFont": {
      "bold": false,
      "color": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
      "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
      "fontSize": 0,
      "italic": false
    },
    "canvasColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "canvasCoverId": "string",
    "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
    "containerConfig": {
      "backgroundColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "borderColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "borderSize": 0,
      "borderStyle": "PAGE_THEME_BORDER_STYLE_UNSPECIFIED",
      "opacity": 0,
      "variant": "PAGE_THEME_CONTAINER_VARIANT_UNSPECIFIED"
    },
    "containerEnabled": false,
    "createdAt": "2026-10-05T09:55:18.784Z",
    "elementColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "elementFont": {
      "bold": false,
      "color": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
      "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
      "fontSize": 0,
      "italic": false
    },
    "id": "string",
    "titleFont": {
      "bold": false,
      "color": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
      "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
      "fontSize": 0,
      "italic": false
    },
    "updatedAt": "2026-10-05T09:55:18.784Z",
    "workspaceId": "string"
  },
  "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "pageThemeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "purpose": "string",
  "qrcodeDesign": {
    "backgroundOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      }
    },
    "centralImageMargin": 0,
    "centralImageSignedUrl": "https://example.com",
    "centralImageSize": 0,
    "cornersDotOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
    },
    "cornersSquareOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
    },
    "createdAt": "2026-10-05T09:55:18.784Z",
    "dotsOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "DOTS_TYPE_UNSPECIFIED"
    },
    "errorCorrectionLevel": "string",
    "height": 0,
    "hideBackgroundDots": false,
    "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
    "shape": "SHAPE_SQUARE",
    "updatedAt": "2026-10-05T09:55:18.784Z",
    "width": 0
  },
  "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
  "qrcodePendingUpdateSince": "2026-10-05T09:55:18.784Z",
  "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
  "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "shortlink": "4BnH-R19p",
  "tags": [
    {
      "createdAt": "2026-10-05T09:55:18.784Z",
      "id": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
      "name": "string",
      "updatedAt": "2026-10-05T09:55:18.784Z"
    }
  ],
  "updatedAt": "2026-10-05T09:55:18.784Z",
  "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
}

GET

/v1/links

Requires auth

#List links

Retrieves the shortened links for your workspace

#Parameters

query parameters

pageSize

integer (int64)

Required

query

The maximum number of links to return.

pageToken

string

query

The token for retrieving the next page of results If not provided, the first page of results will be returned

include

array<string>

query

List of related resources to include in the response. Supported values: "customDomain", "qrcodeDesign", "qrcodeSignedUrl", "tags", "pageTheme". Use "qrcodeSignedUrl" to fetch signed QR image URLs—they are omitted by default to keep requests fast.

tags

array<string>

query

Tags to filter links by (matches links containing any of the provided tags)

string

query

Search query to filter links by name or shortlink Search query to filter links by name or shortlink

sortBy

string

query

Field to sort links by (defaults to updated_at if not specified) Field to sort links by

Allowed values

LINK_SORT_FIELD_UNSPECIFIED

Sort field not specified (defaults to updated_at)

LINK_SORT_FIELD_CREATED_AT

Sort by creation date

LINK_SORT_FIELD_UPDATED_AT

Sort by last update date

LINK_SORT_FIELD_SHORTLINK

Sort by shortlink name

LINK_SORT_FIELD_NAME

Sort by link name

LINK_SORT_FIELD_EVENT_COUNT

Sort by event count

sortDirection

string

query

Sort direction (defaults to descending if not specified) Sort direction (ascending or descending)

Allowed values

SORT_DIRECTION_UNSPECIFIED

Sort direction not specified (defaults to descending)

SORT_DIRECTION_ASC

Sort in ascending order

SORT_DIRECTION_DESC

Sort in descending order

view

string

query

View mode. Default returns all links. LINK_VIEW_DIRECTORY scopes to a directory (or root when directory_id is empty). When directory_id is set, returns links in that directory. When directory_id is empty, returns root-level links (no directory).

Allowed values

LINK_VIEW_UNSPECIFIED

Return all links regardless of directory (default)

LINK_VIEW_DIRECTORY

Return links scoped to a directory.

directoryId

string

query

Directory ID to scope to when view is LINK_VIEW_DIRECTORY. When empty with LINK_VIEW_DIRECTORY, returns root-level links.

#Response

200

Everything worked as expected.

links

array<object>

nextPageToken

string

Cursor to fetch the next page of links

totalCount

integer (int64)

Total number of links matching the current filters

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/links?pageSize={pageSize}&pageToken={pageToken}&include={include}&tags={tags}&search={search}&sortBy={sortBy}&sortDirection={sortDirection}&view={view}&directoryId={directoryId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "links": [
    {
      "createdAt": "2026-10-05T09:55:18.774Z",
      "customDomain": {
        "activatedAt": "2026-10-05T09:55:18.774Z",
        "certificateExpiresAt": "2026-10-05T09:55:18.774Z",
        "cloudflareHostnameStatus": "active",
        "cloudflareSslStatus": "pending_validation",
        "createdAt": "2026-10-05T09:55:18.774Z",
        "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
        "lastCheckedAt": "2026-10-05T09:55:18.774Z",
        "lastError": "string",
        "name": "example.com",
        "rootDestination": "https://example.com",
        "status": "STATUS_ACTIVE",
        "updatedAt": "2026-10-05T09:55:18.774Z",
        "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
      },
      "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
      "entrypoint": "https://linkbreak.ing/4BnH-R19p",
      "eventCount": 128,
      "expiredDestination": "https://example.com/campaign-over",
      "expiresAt": "2026-12-31T23:59:59Z",
      "fallbackDestination": "https://brand.example.com/fallback",
      "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
      "metadata": {},
      "name": "string",
      "pageTheme": {
        "badgeEnabled": false,
        "badgeIconColor": {},
        "badgeId": "string",
        "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
        "bodyFont": {},
        "canvasColor": {},
        "canvasCoverId": "string",
        "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
        "containerConfig": {},
        "containerEnabled": false,
        "createdAt": "2026-10-05T09:55:18.774Z",
        "elementColor": {},
        "elementFont": {},
        "id": "string",
        "titleFont": {},
        "updatedAt": "2026-10-05T09:55:18.774Z",
        "workspaceId": "string"
      },
      "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "pageThemeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
      "purpose": "string",
      "qrcodeDesign": {
        "backgroundOptions": {},
        "centralImageMargin": 0,
        "centralImageSignedUrl": "https://example.com",
        "centralImageSize": 0,
        "cornersDotOptions": {},
        "cornersSquareOptions": {},
        "createdAt": "2026-10-05T09:55:18.774Z",
        "dotsOptions": {},
        "errorCorrectionLevel": "string",
        "height": 0,
        "hideBackgroundDots": false,
        "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
        "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
        "shape": "SHAPE_SQUARE",
        "updatedAt": "2026-10-05T09:55:18.774Z",
        "width": 0
      },
      "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "qrcodePendingUpdateSince": "2026-10-05T09:55:18.774Z",
      "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
      "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
      "shortlink": "4BnH-R19p",
      "tags": [
        {}
      ],
      "updatedAt": "2026-10-05T09:55:18.774Z",
      "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
    }
  ],
  "nextPageToken": "eyJsaW5rSWQiOiI0YmEifQ==",
  "totalCount": 42
}

Base URL: https://api.linkbreakers.com

GET

/v1/links/{id}

Requires auth

#Get link details

Retrieves information about a shortened link including its metadata and metrics.

#Parameters

path parameters

string

Required

path

The ID of the link to retrieve (UUID)

query parameters

include

array<string>

query

#Response

200

Everything worked as expected.

link

object

Core resource that ties a shortlink or QR entrypoint to its workflow, destination, and analytics metadata, letting Linkbreakers serve dynamic experiences while tracking scans for a workspace.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/links/{id}?include={include}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "link": {
    "createdAt": "2026-10-05T09:55:18.782Z",
    "customDomain": {
      "activatedAt": "2026-10-05T09:55:18.782Z",
      "certificateExpiresAt": "2026-10-05T09:55:18.782Z",
      "cloudflareHostnameStatus": "active",
      "cloudflareSslStatus": "pending_validation",
      "createdAt": "2026-10-05T09:55:18.782Z",
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "lastCheckedAt": "2026-10-05T09:55:18.782Z",
      "lastError": "string",
      "name": "example.com",
      "rootDestination": "https://example.com",
      "status": "STATUS_ACTIVE",
      "updatedAt": "2026-10-05T09:55:18.782Z",
      "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
    },
    "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
    "entrypoint": "https://linkbreak.ing/4BnH-R19p",
    "eventCount": 128,
    "expiredDestination": "https://example.com/campaign-over",
    "expiresAt": "2026-12-31T23:59:59Z",
    "fallbackDestination": "https://brand.example.com/fallback",
    "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
    "metadata": {},
    "name": "string",
    "pageTheme": {
      "badgeEnabled": false,
      "badgeIconColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "badgeId": "string",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
      "bodyFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "canvasColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "canvasCoverId": "string",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
      "containerConfig": {
        "backgroundColor": {},
        "borderColor": {},
        "borderSize": 0,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_UNSPECIFIED",
        "opacity": 0,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_UNSPECIFIED"
      },
      "containerEnabled": false,
      "createdAt": "2026-10-05T09:55:18.782Z",
      "elementColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "elementFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "id": "string",
      "titleFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "updatedAt": "2026-10-05T09:55:18.782Z",
      "workspaceId": "string"
    },
    "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "pageThemeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "purpose": "string",
    "qrcodeDesign": {
      "backgroundOptions": {
        "themeColor": {}
      },
      "centralImageMargin": 0,
      "centralImageSignedUrl": "https://example.com",
      "centralImageSize": 0,
      "cornersDotOptions": {
        "themeColor": {},
        "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
      },
      "cornersSquareOptions": {
        "themeColor": {},
        "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
      },
      "createdAt": "2026-10-05T09:55:18.782Z",
      "dotsOptions": {
        "themeColor": {},
        "type": "DOTS_TYPE_UNSPECIFIED"
      },
      "errorCorrectionLevel": "string",
      "height": 0,
      "hideBackgroundDots": false,
      "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
      "shape": "SHAPE_SQUARE",
      "updatedAt": "2026-10-05T09:55:18.782Z",
      "width": 0
    },
    "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "qrcodePendingUpdateSince": "2026-10-05T09:55:18.782Z",
    "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
    "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "shortlink": "4BnH-R19p",
    "tags": [
      {
        "createdAt": "2026-10-05T09:55:18.782Z",
        "id": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
        "name": "string",
        "updatedAt": "2026-10-05T09:55:18.782Z"
      }
    ],
    "updatedAt": "2026-10-05T09:55:18.782Z",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

Base URL: https://api.linkbreakers.com

GET

/v1/links/{linkId}/lead-score/{eventId}

Requires auth

#Get the stored lead score for an event

Returns the score exactly as it was recorded when the visitor came through, together with the factor breakdown and the weighting the link was scored on. Nothing is recalculated here.

#Parameters

path parameters

linkId

string

Required

path

The ID of the link (UUID)

eventId

string

Required

path

The ID of the event for which to generate the explanation (UUID)

#Response

200

Everything worked as expected.

breakdown

object

Breakdown of lead scoring factors

leadScore

integer (int32)

The lead score recorded for this event

recurringScans

integer (int32)

Number of recurring scans from this device+link combination

scoringContext

string

How this link was classified when its weighting was derived, for example "b2b_enterprise" or "community_social".

scoringRationale

string

Plain explanation of why the link is weighted the way it is. Empty when the link scores on the deterministic weighting.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/links/{linkId}/lead-score/{eventId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "breakdown": {
    "brandSupportiveness": 0,
    "engagementLevel": 0,
    "profileFit": 0,
    "recurringInterest": 0,
    "technologicalAptitude": 0
  },
  "leadScore": 0,
  "recurringScans": 0,
  "scoringContext": "string",
  "scoringRationale": "string"
}

Base URL: https://api.linkbreakers.com

GET

/v1/links/shortlink-availability

Requires auth

#Check shortlink availability

Checks if a shortlink is available for use to create a new link. A custom domain can be provided to check against. It typically checks the shortlink slugs and shortlink IDs already present within the system.

#Parameters

query parameters

shortlink

string

query

The shortlink to check availability for.

customDomainId

string

query

The ID of the custom domain to check against (UUID) If not provided, checks against the default domain

#Response

200

Everything worked as expected.

available

boolean

Whether the slug is available for use

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/links/shortlink-availability?shortlink={shortlink}&customDomainId={customDomainId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "available": false
}

Base URL: https://api.linkbreakers.com

GET

/v1/links/shortlink-random

Requires auth

#Get a random shortlink

Generates a random availableshortlink for a new link.

#Parameters

This endpoint does not accept any parameters.

#Response

200

Everything worked as expected.

shortlink

string

Suggested available shortlink slug generated by the service

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/links/shortlink-random" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "shortlink": "string"
}

Base URL: https://api.linkbreakers.com

POST

/v1/links

Requires auth

#Create a new link

This endpoint allows users to create a new shortened URL link in their Linkbreakers workspace. The URL will be checked for malicious content before being shortened.

#Parameters

This endpoint does not accept any parameters.

#Request body

conversionTracking

boolean

Enable conversion tracking by preserving lbid in redirect URL.

customDomainId

string

Optional custom domain ID (UUID). Leave empty to use the default domain.

destination

string

Required

The destination URL to shorten. This field is required.

directoryId

string

Directory to organize this link into. If empty, link is created at root level.

expiredDestination

string

Where visitors are sent once the link has expired. Empty serves the built-in expired page instead.

expiresAt

string (date-time)

When the link stops resolving. Empty means it never expires. Must be in the future. Once it passes the link is removed from the workspace and only the expired destination is served.

fallbackDestination

string

The fallback destination URL to use when workflow steps are broken

string

Optional pre-generated link ID (UUID). Skipped from the AI tool schema: on a create there is no existing link to alias, so exposing it only invites the LLM to invent a raw UUID. The system generates the id and returns it as an alias in the response.

metadata

object

A map of string key-value pairs. All values must be strings. Nested objects or arrays are not supported. Maximum of 50 keys.

name

string

The name of the link

purpose

string

What the user is trying to achieve with this link, in one or two sentences. Lead scoring weights the link from this, and the link's assistant conversations read it as context, so it is restated whenever the workflow changes shape.

qrcodeDesignId

string

The QR Code design ID (UUID).

qrcodeTemplateId

string

The ID of the QR Code template (UUID)

shortlink

string

The shortlink (URL slug) for the link. If not given, a unique one is generated by the system.

tags

array<string>

List of tags to associate with the link. If a tag doesn't exist, it will be created.

waitForQrcode

boolean

Wait for QR code generation to complete before returning response.

#Response

200

Everything worked as expected.

link

object

Core resource that ties a shortlink or QR entrypoint to its workflow, destination, and analytics metadata, letting Linkbreakers serve dynamic experiences while tracking scans for a workspace.

workflowSteps

array<object>

The workflow steps that were created alongside the link. Every link is created with an entry step (event_action EVENT_ACTION_LINK_VISIT, kind KIND_ENTRY) and a default exit step, already connected to each other. They are returned here so a caller never has to guess or look up the entry step's id before attaching its own steps to it.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/links" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"conversionTracking":true,"customDomainId":"d290f1ee-6c54-4b01-90e6-d701748f0851","destination":"https://example.com","directoryId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","expiredDestination":"https://example.com/campaign-over","expiresAt":"2026-12-31T23:59:59Z","fallbackDestination":"https://example.com/fallback","id":"550e8400-e29b-41d4-a716-446655440000","metadata":{},"name":"My Link","purpose":"Increase newsletter signups. Good leads: marketing qualified leads with budget over $10k.","qrcodeDesignId":"a8c5e111-8894-4f8a-b5db-9efe0d12a210","qrcodeTemplateId":"0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d","shortlink":"my-link","tags":["string"],"waitForQrcode":true}'

Sample payload (application/json)

{
  "conversionTracking": true,
  "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "destination": "https://example.com",
  "directoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "expiredDestination": "https://example.com/campaign-over",
  "expiresAt": "2026-12-31T23:59:59Z",
  "fallbackDestination": "https://example.com/fallback",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "metadata": {},
  "name": "My Link",
  "purpose": "Increase newsletter signups. Good leads: marketing qualified leads with budget over $10k.",
  "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
  "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "shortlink": "my-link",
  "tags": [
    "string"
  ],
  "waitForQrcode": true
}

Typical response

{
  "link": {
    "createdAt": "2026-10-05T09:55:18.775Z",
    "customDomain": {
      "activatedAt": "2026-10-05T09:55:18.775Z",
      "certificateExpiresAt": "2026-10-05T09:55:18.775Z",
      "cloudflareHostnameStatus": "active",
      "cloudflareSslStatus": "pending_validation",
      "createdAt": "2026-10-05T09:55:18.775Z",
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "lastCheckedAt": "2026-10-05T09:55:18.775Z",
      "lastError": "string",
      "name": "example.com",
      "rootDestination": "https://example.com",
      "status": "STATUS_ACTIVE",
      "updatedAt": "2026-10-05T09:55:18.775Z",
      "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
    },
    "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
    "entrypoint": "https://linkbreak.ing/4BnH-R19p",
    "eventCount": 128,
    "expiredDestination": "https://example.com/campaign-over",
    "expiresAt": "2026-12-31T23:59:59Z",
    "fallbackDestination": "https://brand.example.com/fallback",
    "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
    "metadata": {},
    "name": "string",
    "pageTheme": {
      "badgeEnabled": false,
      "badgeIconColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "badgeId": "string",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
      "bodyFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "canvasColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "canvasCoverId": "string",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
      "containerConfig": {
        "backgroundColor": {},
        "borderColor": {},
        "borderSize": 0,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_UNSPECIFIED",
        "opacity": 0,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_UNSPECIFIED"
      },
      "containerEnabled": false,
      "createdAt": "2026-10-05T09:55:18.777Z",
      "elementColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "elementFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "id": "string",
      "titleFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "updatedAt": "2026-10-05T09:55:18.777Z",
      "workspaceId": "string"
    },
    "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "pageThemeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "purpose": "string",
    "qrcodeDesign": {
      "backgroundOptions": {
        "themeColor": {}
      },
      "centralImageMargin": 0,
      "centralImageSignedUrl": "https://example.com",
      "centralImageSize": 0,
      "cornersDotOptions": {
        "themeColor": {},
        "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
      },
      "cornersSquareOptions": {
        "themeColor": {},
        "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
      },
      "createdAt": "2026-10-05T09:55:18.777Z",
      "dotsOptions": {
        "themeColor": {},
        "type": "DOTS_TYPE_UNSPECIFIED"
      },
      "errorCorrectionLevel": "string",
      "height": 0,
      "hideBackgroundDots": false,
      "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
      "shape": "SHAPE_SQUARE",
      "updatedAt": "2026-10-05T09:55:18.777Z",
      "width": 0
    },
    "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "qrcodePendingUpdateSince": "2026-10-05T09:55:18.777Z",
    "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
    "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "shortlink": "4BnH-R19p",
    "tags": [
      {
        "createdAt": "2026-10-05T09:55:18.777Z",
        "id": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
        "name": "string",
        "updatedAt": "2026-10-05T09:55:18.777Z"
      }
    ],
    "updatedAt": "2026-10-05T09:55:18.777Z",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  },
  "workflowSteps": [
    {
      "attributeCapture": {
        "enabled": false,
        "writes": []
      },
      "branches": [
        {}
      ],
      "canvasPosition": {
        "x": 0,
        "y": 0
      },
      "childStepIds": [
        "string"
      ],
      "createdAt": "2026-10-05T09:55:18.777Z",
      "eventAction": "EVENT_ACTION_CLIENT_REDIRECT",
      "id": "a5f7b184-9d74-4f2a-9ed9-8f6a98cb12f4",
      "kind": "KIND_INTERACTION",
      "linkId": "123e4567-e89b-12d3-a456-426614174000",
      "nodeType": "NODE_TYPE_COMPOSITE",
      "parentStepIds": [
        "string"
      ],
      "payload": {
        "clientRedirect": {},
        "countryCondition": {},
        "dayOfMonthCondition": {},
        "dayOfWeekCondition": {},
        "deviceActorCondition": {},
        "deviceBrandCondition": {},
        "deviceBrowserCondition": {},
        "devicePlatformCondition": {},
        "deviceTypeCondition": {},
        "form": {},
        "linkVisit": {},
        "messagePage": {},
        "multiLink": {},
        "password": {},
        "socialLinks": {},
        "specificDateCondition": {},
        "thankYouPage": {},
        "timeOfDayCondition": {},
        "vcard": {},
        "visitTypeCondition": {},
        "visitorDataCondition": {}
      },
      "updatedAt": "2026-10-05T09:55:18.777Z"
    }
  ]
}

Base URL: https://api.linkbreakers.com

POST

/v1/links/bulk

Requires auth

#Create multiple links in a single request

Creates links in batch using the same per-link options as Create. This operation is transactional: if one link fails validation or insertion, no links from the batch are created.

#Parameters

This endpoint does not accept any parameters.

#Request body

links

array<object>

Required

Links to create in one batch. Every item supports the same customization fields as CreateLinkRequest.

#Response

200

Everything worked as expected.

links

array<object>

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/links/bulk" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"links":[{"conversionTracking":true,"customDomainId":"d290f1ee-6c54-4b01-90e6-d701748f0851","destination":"https://example.com","directoryId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","expiredDestination":"https://example.com/campaign-over","expiresAt":"2026-12-31T23:59:59Z","fallbackDestination":"https://example.com/fallback","id":"550e8400-e29b-41d4-a716-446655440000","metadata":{},"name":"My Link","purpose":"Increase newsletter signups. Good leads: marketing qualified leads with budget over $10k.","qrcodeDesignId":"a8c5e111-8894-4f8a-b5db-9efe0d12a210","qrcodeTemplateId":"0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d","shortlink":"my-link","tags":["string"],"waitForQrcode":true}]}'

Sample payload (application/json)

{
  "links": [
    {
      "conversionTracking": true,
      "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "destination": "https://example.com",
      "directoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "expiredDestination": "https://example.com/campaign-over",
      "expiresAt": "2026-12-31T23:59:59Z",
      "fallbackDestination": "https://example.com/fallback",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "metadata": {},
      "name": "My Link",
      "purpose": "Increase newsletter signups. Good leads: marketing qualified leads with budget over $10k.",
      "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
      "shortlink": "my-link",
      "tags": [
        "string"
      ],
      "waitForQrcode": true
    }
  ]
}

Typical response

{
  "links": [
    {
      "createdAt": "2026-10-05T09:55:18.778Z",
      "customDomain": {
        "activatedAt": "2026-10-05T09:55:18.778Z",
        "certificateExpiresAt": "2026-10-05T09:55:18.778Z",
        "cloudflareHostnameStatus": "active",
        "cloudflareSslStatus": "pending_validation",
        "createdAt": "2026-10-05T09:55:18.778Z",
        "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
        "lastCheckedAt": "2026-10-05T09:55:18.778Z",
        "lastError": "string",
        "name": "example.com",
        "rootDestination": "https://example.com",
        "status": "STATUS_ACTIVE",
        "updatedAt": "2026-10-05T09:55:18.778Z",
        "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
      },
      "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
      "entrypoint": "https://linkbreak.ing/4BnH-R19p",
      "eventCount": 128,
      "expiredDestination": "https://example.com/campaign-over",
      "expiresAt": "2026-12-31T23:59:59Z",
      "fallbackDestination": "https://brand.example.com/fallback",
      "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
      "metadata": {},
      "name": "string",
      "pageTheme": {
        "badgeEnabled": false,
        "badgeIconColor": {},
        "badgeId": "string",
        "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
        "bodyFont": {},
        "canvasColor": {},
        "canvasCoverId": "string",
        "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
        "containerConfig": {},
        "containerEnabled": false,
        "createdAt": "2026-10-05T09:55:18.778Z",
        "elementColor": {},
        "elementFont": {},
        "id": "string",
        "titleFont": {},
        "updatedAt": "2026-10-05T09:55:18.778Z",
        "workspaceId": "string"
      },
      "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "pageThemeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
      "purpose": "string",
      "qrcodeDesign": {
        "backgroundOptions": {},
        "centralImageMargin": 0,
        "centralImageSignedUrl": "https://example.com",
        "centralImageSize": 0,
        "cornersDotOptions": {},
        "cornersSquareOptions": {},
        "createdAt": "2026-10-05T09:55:18.778Z",
        "dotsOptions": {},
        "errorCorrectionLevel": "string",
        "height": 0,
        "hideBackgroundDots": false,
        "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
        "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
        "shape": "SHAPE_SQUARE",
        "updatedAt": "2026-10-05T09:55:18.778Z",
        "width": 0
      },
      "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "qrcodePendingUpdateSince": "2026-10-05T09:55:18.778Z",
      "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
      "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
      "shortlink": "4BnH-R19p",
      "tags": [
        {}
      ],
      "updatedAt": "2026-10-05T09:55:18.778Z",
      "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
    }
  ]
}

Base URL: https://api.linkbreakers.com

POST

/v1/links/contact

Requires auth

#Create a new contact card link

This endpoint allows users to create a new vCard contact link in their Linkbreakers workspace. The link will generate a vCard file for contact information sharing.

#Parameters

This endpoint does not accept any parameters.

#Request body

customDomainId

string

Optional custom domain ID (UUID). Leave empty to use the default domain. Only provide if the user explicitly asks for a specific custom domain.

directoryId

string

Directory to organize this link into. If empty, link is created at root level.

expiredDestination

string

Where visitors are sent once the link has expired. Empty serves the built-in expired page instead.

expiresAt

string (date-time)

When the link stops resolving. Empty means it never expires. Must be in the future. Once it passes the link is removed from the workspace and only the expired destination is served.

fallbackDestination

string

Optional fallback URL if vCard download fails or is not supported.

string

Optional pre-generated link ID (UUID). The create wizard generates the id up front and navigates to it, so the link has to be created with that id or the page waits on a link that never arrives. Skipped from the AI tool schema for the same reason as on CreateLinkRequest: on a create there is nothing to alias, and exposing it only invites the model to invent a UUID.

metadata

object

A map of string key-value pairs. All values must be strings. Nested objects or arrays are not supported. Maximum of 50 keys.

name

string

The name of the link

purpose

string

qrcodeDesignId

string

The QR Code design ID (UUID). If you include this value, the specified design will be associated to this link only. A design can belong to one record at a time (Link or QR Code Template). Trying to use a design that's already assigned will cause an error.

qrcodeTemplateId

string

The ID of the QR Code template (UUID) If not given, the default QR Code template will be used to generate the QR Code design.

shortlink

string

The shortlink for the link If not given, the shortlink will be generated by the system.

tags

array<string>

List of tags to associate with the link. If a tag doesn't exist, it will be created.

vcardData

object

Required

VCardData contains the contact information for vCard links

waitForQrcode

boolean

Wait for QR code generation to complete. Note: This makes the request slower compared to asynchronous generation.

#Response

200

Everything worked as expected.

link

object

Core resource that ties a shortlink or QR entrypoint to its workflow, destination, and analytics metadata, letting Linkbreakers serve dynamic experiences while tracking scans for a workspace.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/links/contact" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"customDomainId":"d290f1ee-6c54-4b01-90e6-d701748f0851","directoryId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","expiredDestination":"https://example.com/campaign-over","expiresAt":"2026-12-31T23:59:59Z","fallbackDestination":"https://company.com/contact","id":"550e8400-e29b-41d4-a716-446655440000","metadata":{},"name":"Jane Doe Contact Card","purpose":"Capture contact details for sales outreach. Good leads: business contacts interested in our services.","qrcodeDesignId":"a8c5e111-8894-4f8a-b5db-9efe0d12a210","qrcodeTemplateId":"0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d","shortlink":"jane-contact","tags":["string"],"vcardData":{"buttonLabel":"Add to contacts","city":"San Francisco","country":"United States","email":"[email protected]","firstName":"Jane","lastName":"Doe","organization":"Acme Corporation","phone":"+33123456789","phoneIsWhatsapp":false,"postalCode":"94102","socialLinks":[{"platform":"linkedin","url":"https://linkedin.com/in/janedoe"}],"state":"CA","streetAddress":"123 Main Street","title":"Software Engineer","website":"https://acme.com"},"waitForQrcode":true}'

Sample payload (application/json)

{
  "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "directoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "expiredDestination": "https://example.com/campaign-over",
  "expiresAt": "2026-12-31T23:59:59Z",
  "fallbackDestination": "https://company.com/contact",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "metadata": {},
  "name": "Jane Doe Contact Card",
  "purpose": "Capture contact details for sales outreach. Good leads: business contacts interested in our services.",
  "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
  "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "shortlink": "jane-contact",
  "tags": [
    "string"
  ],
  "vcardData": {
    "buttonLabel": "Add to contacts",
    "city": "San Francisco",
    "country": "United States",
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Doe",
    "organization": "Acme Corporation",
    "phone": "+33123456789",
    "phoneIsWhatsapp": false,
    "postalCode": "94102",
    "socialLinks": [
      {
        "platform": "linkedin",
        "url": "https://linkedin.com/in/janedoe"
      }
    ],
    "state": "CA",
    "streetAddress": "123 Main Street",
    "title": "Software Engineer",
    "website": "https://acme.com"
  },
  "waitForQrcode": true
}

Typical response

{
  "link": {
    "createdAt": "2026-10-05T09:55:18.778Z",
    "customDomain": {
      "activatedAt": "2026-10-05T09:55:18.778Z",
      "certificateExpiresAt": "2026-10-05T09:55:18.778Z",
      "cloudflareHostnameStatus": "active",
      "cloudflareSslStatus": "pending_validation",
      "createdAt": "2026-10-05T09:55:18.778Z",
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "lastCheckedAt": "2026-10-05T09:55:18.778Z",
      "lastError": "string",
      "name": "example.com",
      "rootDestination": "https://example.com",
      "status": "STATUS_ACTIVE",
      "updatedAt": "2026-10-05T09:55:18.778Z",
      "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
    },
    "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
    "entrypoint": "https://linkbreak.ing/4BnH-R19p",
    "eventCount": 128,
    "expiredDestination": "https://example.com/campaign-over",
    "expiresAt": "2026-12-31T23:59:59Z",
    "fallbackDestination": "https://brand.example.com/fallback",
    "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
    "metadata": {},
    "name": "string",
    "pageTheme": {
      "badgeEnabled": false,
      "badgeIconColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "badgeId": "string",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
      "bodyFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "canvasColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "canvasCoverId": "string",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
      "containerConfig": {
        "backgroundColor": {},
        "borderColor": {},
        "borderSize": 0,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_UNSPECIFIED",
        "opacity": 0,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_UNSPECIFIED"
      },
      "containerEnabled": false,
      "createdAt": "2026-10-05T09:55:18.779Z",
      "elementColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "elementFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "id": "string",
      "titleFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "updatedAt": "2026-10-05T09:55:18.779Z",
      "workspaceId": "string"
    },
    "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "pageThemeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "purpose": "string",
    "qrcodeDesign": {
      "backgroundOptions": {
        "themeColor": {}
      },
      "centralImageMargin": 0,
      "centralImageSignedUrl": "https://example.com",
      "centralImageSize": 0,
      "cornersDotOptions": {
        "themeColor": {},
        "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
      },
      "cornersSquareOptions": {
        "themeColor": {},
        "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
      },
      "createdAt": "2026-10-05T09:55:18.779Z",
      "dotsOptions": {
        "themeColor": {},
        "type": "DOTS_TYPE_UNSPECIFIED"
      },
      "errorCorrectionLevel": "string",
      "height": 0,
      "hideBackgroundDots": false,
      "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
      "shape": "SHAPE_SQUARE",
      "updatedAt": "2026-10-05T09:55:18.779Z",
      "width": 0
    },
    "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "qrcodePendingUpdateSince": "2026-10-05T09:55:18.779Z",
    "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
    "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "shortlink": "4BnH-R19p",
    "tags": [
      {
        "createdAt": "2026-10-05T09:55:18.779Z",
        "id": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
        "name": "string",
        "updatedAt": "2026-10-05T09:55:18.779Z"
      }
    ],
    "updatedAt": "2026-10-05T09:55:18.779Z",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

Base URL: https://api.linkbreakers.com

POST

/v1/links/qrcode-images:resolve

Requires auth

#Resolve QR code image URLs

Return freshly signed QR code image URLs for the given links. The URLs expire, so callers fetch them when they need to render rather than storing them.

#Parameters

This endpoint does not accept any parameters.

#Request body

linkIds

array<string>

Required

The links to resolve images for. Ids outside the caller's workspace, and links with no generated QR code yet, are simply absent from the response rather than failing the whole batch: a list draws the rows it can.

#Response

200

Everything worked as expected.

qrcodeSignedUrls

object

Signed URL by link id. These expire, so treat them as good for this session and ask again rather than persisting them.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/links/qrcode-images:resolve" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"linkIds":["string"]}'

Sample payload (application/json)

{
  "linkIds": [
    "string"
  ]
}

Typical response

{
  "qrcodeSignedUrls": {}
}

Base URL: https://api.linkbreakers.com

POST

/v1/links/thank-you

Requires auth

#Create a new thank you page link

This endpoint allows users to create a new link with a thank you page as the exit step.

#Parameters

This endpoint does not accept any parameters.

#Request body

customDomainId

string

Optional custom domain ID (UUID). Leave empty to use the default domain. Only provide if the user explicitly asks for a specific custom domain.

description

string

Optional description displayed on the thank you page.

directoryId

string

Directory to organize this link into. If empty, link is created at root level.

expiredDestination

string

Where visitors are sent once the link has expired. Empty serves the built-in expired page instead.

expiresAt

string (date-time)

When the link stops resolving. Empty means it never expires. Must be in the future. Once it passes the link is removed from the workspace and only the expired destination is served.

string

Optional pre-generated link ID (UUID). Same contract as on CreateLinkRequest: the caller may pick the id so a page can navigate to the link before it exists, and it is skipped from the AI tool schema so the model is never invited to invent one.

metadata

object

A map of string key-value pairs. All values must be strings. Nested objects or arrays are not supported. Maximum of 50 keys.

name

string

The name of the link

purpose

string

qrcodeDesignId

string

qrcodeTemplateId

string

The ID of the QR Code template (UUID) If not given, the default QR Code template will be used to generate the QR Code design.

shortlink

string

The shortlink for the link If not given, the shortlink will be generated by the system.

tags

array<string>

List of tags to associate with the link. If a tag doesn't exist, it will be created.

title

string

Required

Title displayed on the thank you page. This field is required.

waitForQrcode

boolean

Wait for QR code generation to complete. Note: This makes the request slower compared to asynchronous generation.

#Response

200

Everything worked as expected.

link

object

Core resource that ties a shortlink or QR entrypoint to its workflow, destination, and analytics metadata, letting Linkbreakers serve dynamic experiences while tracking scans for a workspace.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/links/thank-you" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"customDomainId":"d290f1ee-6c54-4b01-90e6-d701748f0851","description":"We appreciate your visit.","directoryId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","expiredDestination":"https://example.com/campaign-over","expiresAt":"2026-12-31T23:59:59Z","id":"550e8400-e29b-41d4-a716-446655440000","metadata":{},"name":"Thank You Page Link","purpose":"Thank visitors after a purchase and measure engagement. Good leads: visitors who completed a purchase.","qrcodeDesignId":"a8c5e111-8894-4f8a-b5db-9efe0d12a210","qrcodeTemplateId":"0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d","shortlink":"thank-you","tags":["string"],"title":"Thank you!","waitForQrcode":true}'

Sample payload (application/json)

{
  "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "description": "We appreciate your visit.",
  "directoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "expiredDestination": "https://example.com/campaign-over",
  "expiresAt": "2026-12-31T23:59:59Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "metadata": {},
  "name": "Thank You Page Link",
  "purpose": "Thank visitors after a purchase and measure engagement. Good leads: visitors who completed a purchase.",
  "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
  "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "shortlink": "thank-you",
  "tags": [
    "string"
  ],
  "title": "Thank you!",
  "waitForQrcode": true
}

Typical response

{
  "link": {
    "createdAt": "2026-10-05T09:55:18.781Z",
    "customDomain": {
      "activatedAt": "2026-10-05T09:55:18.781Z",
      "certificateExpiresAt": "2026-10-05T09:55:18.781Z",
      "cloudflareHostnameStatus": "active",
      "cloudflareSslStatus": "pending_validation",
      "createdAt": "2026-10-05T09:55:18.781Z",
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "lastCheckedAt": "2026-10-05T09:55:18.781Z",
      "lastError": "string",
      "name": "example.com",
      "rootDestination": "https://example.com",
      "status": "STATUS_ACTIVE",
      "updatedAt": "2026-10-05T09:55:18.781Z",
      "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
    },
    "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
    "entrypoint": "https://linkbreak.ing/4BnH-R19p",
    "eventCount": 128,
    "expiredDestination": "https://example.com/campaign-over",
    "expiresAt": "2026-12-31T23:59:59Z",
    "fallbackDestination": "https://brand.example.com/fallback",
    "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
    "metadata": {},
    "name": "string",
    "pageTheme": {
      "badgeEnabled": false,
      "badgeIconColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "badgeId": "string",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
      "bodyFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "canvasColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "canvasCoverId": "string",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
      "containerConfig": {
        "backgroundColor": {},
        "borderColor": {},
        "borderSize": 0,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_UNSPECIFIED",
        "opacity": 0,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_UNSPECIFIED"
      },
      "containerEnabled": false,
      "createdAt": "2026-10-05T09:55:18.781Z",
      "elementColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "elementFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "id": "string",
      "titleFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "updatedAt": "2026-10-05T09:55:18.781Z",
      "workspaceId": "string"
    },
    "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "pageThemeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "purpose": "string",
    "qrcodeDesign": {
      "backgroundOptions": {
        "themeColor": {}
      },
      "centralImageMargin": 0,
      "centralImageSignedUrl": "https://example.com",
      "centralImageSize": 0,
      "cornersDotOptions": {
        "themeColor": {},
        "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
      },
      "cornersSquareOptions": {
        "themeColor": {},
        "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
      },
      "createdAt": "2026-10-05T09:55:18.781Z",
      "dotsOptions": {
        "themeColor": {},
        "type": "DOTS_TYPE_UNSPECIFIED"
      },
      "errorCorrectionLevel": "string",
      "height": 0,
      "hideBackgroundDots": false,
      "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
      "shape": "SHAPE_SQUARE",
      "updatedAt": "2026-10-05T09:55:18.781Z",
      "width": 0
    },
    "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "qrcodePendingUpdateSince": "2026-10-05T09:55:18.781Z",
    "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
    "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "shortlink": "4BnH-R19p",
    "tags": [
      {
        "createdAt": "2026-10-05T09:55:18.782Z",
        "id": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
        "name": "string",
        "updatedAt": "2026-10-05T09:55:18.782Z"
      }
    ],
    "updatedAt": "2026-10-05T09:55:18.782Z",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

Base URL: https://api.linkbreakers.com

PATCH

/v1/links/{id}

Requires auth

#Update a link

Updates an existing shortened link in your Linkbreakers workspace.

#Parameters

path parameters

string

Required

path

The ID of the link to update (UUID)

#Request body

directoryId

string

The ID of the directory to move this link into (UUID)

directoryIdDelete

boolean

Remove the link from its directory (move to root) If true, the directory_id will be set to null

expiredDestination

string

Where visitors are sent once the link has expired. Empty serves the built-in expired page instead.

expiredDestinationDelete

boolean

Remove the expired destination from this link. If true, expired_destination is cleared and expired visitors see the built-in expired page instead.

expiresAt

string (date-time)

When the link stops resolving. Empty leaves the current value untouched. Must be in the future. Once it passes the link is removed from the workspace and only the expired destination is served.

expiresAtDelete

boolean

Remove the expiration from this link. If true, expires_at is cleared and the link stops expiring.

fallbackDestination

string

The fallback destination URL to use when workflow steps are broken

name

string

The new name of the link

pageThemeId

string

Page theme ID to assign to this link

purpose

string

qrcodeTemplateId

string

QR code template ID to assign to this link

qrcodeTemplateIdDelete

boolean

Delete the QR code template ID from this link If true, the qrcode_template_id will be set to null

tags

array<string>

Set the tags to associate with the link. If a tag with the given name doesn't exist, it will be created.

tagsDelete

boolean

Delete all tags from the link If true, all tags will be removed from the link.

#Response

200

Everything worked as expected.

link

object

Core resource that ties a shortlink or QR entrypoint to its workflow, destination, and analytics metadata, letting Linkbreakers serve dynamic experiences while tracking scans for a workspace.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X PATCH "https://api.linkbreakers.com/v1/links/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"directoryId":"d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f","directoryIdDelete":false,"expiredDestination":"https://example.com/campaign-over","expiredDestinationDelete":false,"expiresAt":"2026-12-31T23:59:59Z","expiresAtDelete":false,"fallbackDestination":"https://example.com/fallback","name":"My Updated Link","pageThemeId":"f47ac10b-58cc-4372-a567-0e02b2c3d479","purpose":"Increase newsletter signups. Good leads: marketing qualified leads with budget over $10k.","qrcodeTemplateId":"0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d","qrcodeTemplateIdDelete":false,"tags":["string"],"tagsDelete":false}'

Sample payload (application/json)

{
  "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
  "directoryIdDelete": false,
  "expiredDestination": "https://example.com/campaign-over",
  "expiredDestinationDelete": false,
  "expiresAt": "2026-12-31T23:59:59Z",
  "expiresAtDelete": false,
  "fallbackDestination": "https://example.com/fallback",
  "name": "My Updated Link",
  "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "purpose": "Increase newsletter signups. Good leads: marketing qualified leads with budget over $10k.",
  "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "qrcodeTemplateIdDelete": false,
  "tags": [
    "string"
  ],
  "tagsDelete": false
}

Typical response

{
  "link": {
    "createdAt": "2026-10-05T09:55:18.783Z",
    "customDomain": {
      "activatedAt": "2026-10-05T09:55:18.783Z",
      "certificateExpiresAt": "2026-10-05T09:55:18.783Z",
      "cloudflareHostnameStatus": "active",
      "cloudflareSslStatus": "pending_validation",
      "createdAt": "2026-10-05T09:55:18.783Z",
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "lastCheckedAt": "2026-10-05T09:55:18.783Z",
      "lastError": "string",
      "name": "example.com",
      "rootDestination": "https://example.com",
      "status": "STATUS_ACTIVE",
      "updatedAt": "2026-10-05T09:55:18.783Z",
      "workspaceId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
    },
    "customDomainId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "directoryId": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
    "entrypoint": "https://linkbreak.ing/4BnH-R19p",
    "eventCount": 128,
    "expiredDestination": "https://example.com/campaign-over",
    "expiresAt": "2026-12-31T23:59:59Z",
    "fallbackDestination": "https://brand.example.com/fallback",
    "id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
    "metadata": {},
    "name": "string",
    "pageTheme": {
      "badgeEnabled": false,
      "badgeIconColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "badgeId": "string",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_UNSPECIFIED",
      "bodyFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "canvasColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "canvasCoverId": "string",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_UNSPECIFIED",
      "containerConfig": {
        "backgroundColor": {},
        "borderColor": {},
        "borderSize": 0,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_UNSPECIFIED",
        "opacity": 0,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_UNSPECIFIED"
      },
      "containerEnabled": false,
      "createdAt": "2026-10-05T09:55:18.783Z",
      "elementColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "elementFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "id": "string",
      "titleFont": {
        "bold": false,
        "color": {},
        "family": "PAGE_THEME_FONT_FAMILY_UNSPECIFIED",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 0,
        "italic": false
      },
      "updatedAt": "2026-10-05T09:55:18.783Z",
      "workspaceId": "string"
    },
    "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "pageThemeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "purpose": "string",
    "qrcodeDesign": {
      "backgroundOptions": {
        "themeColor": {}
      },
      "centralImageMargin": 0,
      "centralImageSignedUrl": "https://example.com",
      "centralImageSize": 0,
      "cornersDotOptions": {
        "themeColor": {},
        "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
      },
      "cornersSquareOptions": {
        "themeColor": {},
        "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
      },
      "createdAt": "2026-10-05T09:55:18.783Z",
      "dotsOptions": {
        "themeColor": {},
        "type": "DOTS_TYPE_UNSPECIFIED"
      },
      "errorCorrectionLevel": "string",
      "height": 0,
      "hideBackgroundDots": false,
      "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
      "shape": "SHAPE_SQUARE",
      "updatedAt": "2026-10-05T09:55:18.783Z",
      "width": 0
    },
    "qrcodeDesignId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "qrcodePendingUpdateSince": "2026-10-05T09:55:18.783Z",
    "qrcodeSignedUrl": "https://cdn.linkbreakers.com/qrcodes/1b9d6bcd.png?signature=abc123",
    "qrcodeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "shortlink": "4BnH-R19p",
    "tags": [
      {
        "createdAt": "2026-10-05T09:55:18.783Z",
        "id": "d87a9b30-5c8b-4d4e-9fd3-5f5f5f5f5f5f",
        "name": "string",
        "updatedAt": "2026-10-05T09:55:18.783Z"
      }
    ],
    "updatedAt": "2026-10-05T09:55:18.783Z",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

Base URL: https://api.linkbreakers.com

DELETE

/v1/links/{id}

Requires auth

#Delete a link

Removes a shortened link from the workspace. This operation cannot be undone.

#Parameters

path parameters

string

Required

path

The ID of the link to delete (UUID)

#Response

200

Everything worked as expected.

No structured schema available for this section.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.