Media API Reference

#The Media object

Stores workspace-managed assets such as QR center logos or downloadable files that Linkbreakers signs and serves alongside link experiences.

createdAt

string (date-time)

When the file was created

fileName

string

The name of the file

string

The unique identifier of the media file (UUID)

mediaType

string (enum)

MediaType represents the type of media

Allowed values

TYPE_UNSPECIFIED

The media type is not specified

TYPE_CENTRAL_QRCODE_IMAGE

The media type is a central QR code image

mimeType

string

The MIME type of the file

signedUrl

string

Short-lived signed URL for downloading the media asset

size

string (int64)

The size of the file in bytes

updatedAt

string (date-time)

When the file was last updated

uploadedBy

string

The member who uploaded the file If it was uploaded through the public API, or if the member was removed from the workspace, the uploaded_by will be null.

visibility

string (enum)

The media visibility is not specified

Allowed values

VISIBILITY_UNSPECIFIED

Media visibility not specified

VISIBILITY_PUBLIC

The media visibility is public

VISIBILITY_PRIVATE

The media visibility is private

workspaceId

string

The workspace ID the media file belongs to (UUID)

Learn more

Learn more about media files in Linkbreakers

Example object

{
  "createdAt": "2025-10-29T08:03:02.734Z",
  "fileName": "string",
  "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
  "mediaType": "TYPE_CENTRAL_QRCODE_IMAGE",
  "mimeType": "string",
  "signedUrl": "https://example.com",
  "size": "string",
  "updatedAt": "2025-10-29T08:03:02.734Z",
  "uploadedBy": "string",
  "visibility": "VISIBILITY_PRIVATE",
  "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
}

GET/v1/mediaRequires auth

#List media files

Retrieves the media files for your workspace

#Parameters

query parameters

pageSize

integer (int32)Requiredquery

The maximum number of media files to return.

pageToken

stringquery

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

#Response

200

Everything worked as expected.

media

array<object>

Page of media entries including fresh signed URLs

nextPageToken

string

Cursor to continue listing media assets

#Error response

400-599

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

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/media?pageSize={pageSize}&pageToken={pageToken}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "media": [
    {
      "createdAt": "2025-10-29T08:03:02.734Z",
      "fileName": "string",
      "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
      "mediaType": "TYPE_CENTRAL_QRCODE_IMAGE",
      "mimeType": "string",
      "signedUrl": "https://example.com",
      "size": "string",
      "updatedAt": "2025-10-29T08:03:02.734Z",
      "uploadedBy": "string",
      "visibility": "VISIBILITY_PRIVATE",
      "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
    }
  ],
  "nextPageToken": "eyJtZWRpYUlkIjoiNWIifQ=="
}

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

GET/v1/media/{id}Requires auth

#Get media file details

Retrieves information about a media file including its metadata and URL. Example: Getting details for media with ID "med_123".

#Parameters

path parameters

stringRequiredpath

The ID of the media file to retrieve (UUID)

#Response

200

Everything worked as expected.

media

object

Stores workspace-managed assets such as QR center logos or downloadable files that Linkbreakers signs and serves alongside link experiences.

#Error response

400-599

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

error

objectRequired

Wrapped error response.

Example request (cURL)

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

Typical response

{
  "media": {
    "createdAt": "2025-10-29T08:03:02.734Z",
    "fileName": "string",
    "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
    "mediaType": "TYPE_CENTRAL_QRCODE_IMAGE",
    "mimeType": "string",
    "signedUrl": "https://example.com",
    "size": "string",
    "updatedAt": "2025-10-29T08:03:02.734Z",
    "uploadedBy": "string",
    "visibility": "VISIBILITY_PRIVATE",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

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

POST/v1/mediaRequires auth

#Upload a media file

This endpoint allows users to upload a new media file to their Linkbreakers workspace. For now the file size limit is 3MB. Example: Uploading an image to be placed in the center of a QR Code.

#Parameters

This endpoint does not accept any parameters.

#Request body

fileData

string

The file data to upload. The file size limit is 3MB. It must be transmitted in a base64 string format when sending it through HTTP. Accepted formats are PNG and JPEG.

fileName

string

The name of the file

mediaType

string (enum)

MediaType represents the type of media

Allowed values

TYPE_UNSPECIFIED

The media type is not specified

TYPE_CENTRAL_QRCODE_IMAGE

The media type is a central QR code image

visibility

string (enum)

The media visibility is not specified

Allowed values

VISIBILITY_UNSPECIFIED

Media visibility not specified

VISIBILITY_PUBLIC

The media visibility is public

VISIBILITY_PRIVATE

The media visibility is private

#Response

200

Everything worked as expected.

media

object

Stores workspace-managed assets such as QR center logos or downloadable files that Linkbreakers signs and serves alongside link experiences.

#Error response

400-599

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

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/media" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"fileData":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==","fileName":"example.jpg","mediaType":"TYPE_UNSPECIFIED","visibility":"VISIBILITY_UNSPECIFIED"}'

Sample payload (application/json)

{
  "fileData": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "fileName": "example.jpg",
  "mediaType": "TYPE_UNSPECIFIED",
  "visibility": "VISIBILITY_UNSPECIFIED"
}

Typical response

{
  "media": {
    "createdAt": "2025-10-29T08:03:02.734Z",
    "fileName": "string",
    "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
    "mediaType": "TYPE_CENTRAL_QRCODE_IMAGE",
    "mimeType": "string",
    "signedUrl": "https://example.com",
    "size": "string",
    "updatedAt": "2025-10-29T08:03:02.734Z",
    "uploadedBy": "string",
    "visibility": "VISIBILITY_PRIVATE",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

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

DELETE/v1/media/{id}Requires auth

#Delete a media file

Removes a media file from the workspace. This operation cannot be undone.

#Parameters

path parameters

stringRequiredpath

The ID of the media file 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

objectRequired

Wrapped error response.