#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

TYPE_BACKGROUND_COVER

The media type is a background cover for page themes

TYPE_BADGE

The media type is a badge image for page themes

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": "2026-10-05T03:43:08.010Z",
  "fileName": "string",
  "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
  "mediaType": "TYPE_CENTRAL_QRCODE_IMAGE",
  "mimeType": "string",
  "signedUrl": "https://example.com",
  "size": "string",
  "updatedAt": "2026-10-05T03:43:08.010Z",
  "uploadedBy": "string",
  "visibility": "VISIBILITY_PRIVATE",
  "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
}

GET

/v1/media

Requires auth

#List media files

Retrieves the media files for your workspace

#Parameters

query parameters

pageSize

integer (int64)

Required

query

The maximum number of media files 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

#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

object

Required

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": "2026-10-05T03:43:08.010Z",
      "fileName": "string",
      "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
      "mediaType": "TYPE_CENTRAL_QRCODE_IMAGE",
      "mimeType": "string",
      "signedUrl": "https://example.com",
      "size": "string",
      "updatedAt": "2026-10-05T03:43:08.010Z",
      "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

string

Required

path

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

object

Required

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": "2026-10-05T03:43:08.010Z",
    "fileName": "string",
    "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
    "mediaType": "TYPE_CENTRAL_QRCODE_IMAGE",
    "mimeType": "string",
    "signedUrl": "https://example.com",
    "size": "string",
    "updatedAt": "2026-10-05T03:43:08.010Z",
    "uploadedBy": "string",
    "visibility": "VISIBILITY_PRIVATE",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}

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

POST

/v1/media

Requires 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

TYPE_BACKGROUND_COVER

The media type is a background cover for page themes

TYPE_BADGE

The media type is a badge image for page themes

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

object

Required

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": "2026-10-05T03:43:08.010Z",
    "fileName": "string",
    "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
    "mediaType": "TYPE_CENTRAL_QRCODE_IMAGE",
    "mimeType": "string",
    "signedUrl": "https://example.com",
    "size": "string",
    "updatedAt": "2026-10-05T03:43:08.010Z",
    "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

string

Required

path

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

object

Required

Wrapped error response.