Media API

GET/v1/media

Return the media library: images, videos, PDFs, presentations, fonts, web links, and app-backed assets. Use limit and cursor to page through results, count=1 to include a total count, search to search by name or tag, and the comma-separated kind, state, and folderId parameters to filter. Paging is optional but recommended, since a library can hold thousands of items. Without limit, every visible asset comes back unordered and without nextCursor. With limit, rows are newest first.

curl "https://api.brixsignage.com/v1/media" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

{
  "data": [
    {
      "id": "med_0c1d2e3f4a5b6c7d",
      "spaceId": "space_1a2b3c4d5e6f7a8b",
      "name": "lunch-special.jpg",
      "kind": "image",
      "url": "/v1/media/med_0c1d2e3f4a5b6c7d/file",
      "bytes": 482113,
      "checksum": null,
      "active": true,
      "folderId": null,
      "tags": [
        "menu",
        "lunch"
      ],
      "altText": "Grilled chicken wrap with fries",
      "thumbnailUrl": null,
      "width": 1920,
      "height": 1080,
      "durationSec": null,
      "pdfPageCount": null,
      "loopDurationMs": null,
      "fontFamily": null,
      "fontWeights": null,
      "state": "ready",
      "stateReason": null,
      "stateCode": null,
      "stateFault": null,
      "stateProgress": null,
      "codec": null,
      "playableRev": 0,
      "loopState": null,
      "loopCodecs": null,
      "loopRev": null,
      "loopRotation": null,
      "loopBytes": null,
      "masterKey": null,
      "masterBytes": null,
      "masterProbe": null,
      "rendition4k": null,
      "frameLumaMean": null,
      "frameLumaVariance": null,
      "frameEdgeDensity": null,
      "startsAt": null,
      "expiresAt": null,
      "autoArchiveOnExpiry": false,
      "qr": null,
      "webConfig": null,
      "replayState": null,
      "lastReplayAt": null,
      "lastReplaySuccessAt": null,
      "lastFailedStep": null,
      "lastFailedReason": null,
      "autoCaption": false,
      "captionTrackKey": null,
      "captionState": null,
      "showCaptions": true,
      "audioEnabled": false,
      "focalRegion": null,
      "fit": "contain",
      "autoSmartFit": true,
      "rotation": 0,
      "originalFormat": null,
      "packageEntry": null,
      "packageFiles": null,
      "packageBytes": null,
      "importSourceId": null,
      "nodeId": null,
      "recalledAt": null,
      "recalledBy": null,
      "createdAt": "2026-09-20T10:15:00.000Z",
      "updatedAt": "2026-09-20T10:15:00.000Z",
      "deletedAt": null,
      "usageCount": 2,
      "uploadedByName": "Sam Rivera",
      "uploadSource": "ui"
    }
  ],
  "nextCursor": null,
  "total": 1
}

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media

Create a media asset record for a file whose bytes are already stored elsewhere, by providing name, kind, and url. This creates only the metadata record; to upload new file bytes, use POST /v1/media/upload, PUT /v1/media/upload/:uploadId, or POST /v1/media/import-url instead. **Notes.** - The 201 body is the row as written, not re-read: columns the create does not set are absent rather than null. GET returns every column. - Use this for links (web pages, streams, dashboards). To add a FILE, use POST /v1/media/upload, the multipart upload, or POST /v1/media/import-url.

Request body application/json

curl -X POST "https://api.brixsignage.com/v1/media" \
  -H "Authorization: Bearer $BRIX_API_KEY" \
  -H "Content-Type: application/json"

Response 201 Success.

Response 400 `fit` is not a known value.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 The folder or location does not exist.

Response 422 `name`, `kind` or `url` is missing, or `kind` is unknown.

Response 5XX Server error. The body carries a `requestId` to quote to support.

GET/v1/media/{id}

Return one media asset with its full details, including kind, url, dimensions, duration, tags, folder, play window, and web configuration.

curl "https://api.brixsignage.com/v1/media/{id}" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No such asset in this workspace (or it is in the recycle bin).

Response 5XX Server error. The body carries a `requestId` to quote to support.

PATCH/v1/media/{id}

Edit a media asset. Accepts name, altText, tags, folderId, node, play-window fields (startsAt, expiresAt, autoArchiveOnExpiry), audioEnabled, a QR code overlay, and web configuration. Changing the URL of a web-kind asset re-checks it to make sure it is safe to fetch. Send only the fields to change. state and bytes are set by processing and ignored here. **Notes.** - The response is the stored row, not the GET shape: it has no usageCount, uploadedByName or uploadSource. - An invalid fit answers 400 with only error (no message); every other validation failure is 422 validation_error.

Request body application/json

curl -X PATCH "https://api.brixsignage.com/v1/media/{id}" \
  -H "Authorization: Bearer $BRIX_API_KEY" \
  -H "Content-Type: application/json"

Response 200 Success.

Response 400 `fit` is not one of contain, cover, fill, blur-fill.

Response 401 Missing, expired or revoked bearer token.

Response 403 Moving it to a location where you lack media.edit, or attaching an SSO connection without settings.edit.

Response 404 No such asset in this workspace.

Response 409 `conflict`: `baseUpdatedAt` is stale; the body carries `current`.

Response 422 Invalid kind, URL, folder or location.

Response 5XX Server error. The body carries a `requestId` to quote to support.

DELETE/v1/media/{id}

Move a media asset to the recycle bin. Playlists and screens that reference it show a gap where the asset was until it is restored or replaced. Moves the asset to the recycle bin (restorable for 30 days) and removes it from every playlist. Screens casting it return to their schedule.

curl -X DELETE "https://api.brixsignage.com/v1/media/{id}" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No such asset in this workspace.

Response 409 `content_shared`: the item is shared into other places; `shareCount`, `crossSpaceShares`, `contentShares` say where. Repeat with `?force=true` to delete it and those shares.

Response 5XX Server error. The body carries a `requestId` to quote to support.

GET/v1/media/{id}/captions

Return a video's caption track as WebVTT. Add ?lang= to request a machine-translated version, for example ?lang=es for Spanish. This URL is stable, so it can be referenced directly by a player.

curl "https://api.brixsignage.com/v1/media/{id}/captions" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id, or it has no captions.

Response 429 More than 60 reads a minute.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/{id}/captions

Automatically generate a caption track for a video from its audio and attach it to the asset. To upload a caption file instead, use the caption upload operation. To show or hide an existing caption track, use the caption visibility operation.

curl -X POST "https://api.brixsignage.com/v1/media/{id}/captions" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 400 `wrong_kind`: not a video.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id, or no bytes.

Response 413 Over 40 MB: send the audio to /captions/transcribe instead.

Response 502 `transcription_failed`.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/{id}/captions/transcribe

Convert a short audio clip, extracted from a video as 16 kHz mono WAV, into a caption track. Use this instead of the standard caption-generation operation when the full video file is too large to process directly.

curl -X POST "https://api.brixsignage.com/v1/media/{id}/captions/transcribe" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 400 `wrong_kind`: not a video.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id.

Response 413 Over 20 MB.

Response 422 Empty body.

Response 502 `transcription_failed`.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/{id}/captions/upload

Attach a caption file to a video. SRT files are converted to WebVTT; WebVTT files are stored as-is. This is the alternative to automatic caption generation.

curl -X POST "https://api.brixsignage.com/v1/media/{id}/captions/upload" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 400 `wrong_kind`: not a video.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id.

Response 413 Over 5 MB.

Response 415 Not a .vtt or .srt track.

Response 422 Empty body.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/{id}/captions/visibility

Turn a video's caption track on or off for playback. Hiding the track keeps it in storage so it can be shown again later. If no caption track exists yet, the response indicates that one must be generated first.

Request body application/json

curl -X POST "https://api.brixsignage.com/v1/media/{id}/captions/visibility" \
  -H "Authorization: Bearer $BRIX_API_KEY" \
  -H "Content-Type: application/json"

Response 200 Success.

Response 400 `wrong_kind`: not a video.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id.

Response 5XX Server error. The body carries a `requestId` to quote to support.

GET/v1/media/{id}/delta

Used by playback devices to check whether their cached copy of a file is current. The caller sends the checksum of its cached copy and receives either the data needed to update it, or a flag indicating no partial update is available along with a URL to download the full file. **Notes.** - Reserved: delta downloads are not offered yet, so this always answers deltaAvailable: false.

curl "https://api.brixsignage.com/v1/media/{id}/delta" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 5XX Server error. The body carries a `requestId` to quote to support.

GET/v1/media/{id}/file

Stream the media asset's file bytes. Supports HTTP Range requests for partial downloads. **Notes.** - HTML, SVG and script files are served as application/octet-stream attachments, never inline.

curl "https://api.brixsignage.com/v1/media/{id}/file" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id, or the file is not in storage.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/{id}/focal-region

Detect the main subject of an image and cache its position as a normalized x, y, width, and height. This lets the image be cropped around its subject when shown in a differently shaped area, instead of being cropped from the center.

curl -X POST "https://api.brixsignage.com/v1/media/{id}/focal-region" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 400 `wrong_kind`: not an image.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id, or no bytes.

Response 413 Over 32 MB.

Response 5XX Server error. The body carries a `requestId` to quote to support.

GET/v1/media/{id}/playback-quality

Return dropped-frame data reported by screens that have played this video, used to flag videos that are not playing smoothly. A null health value means the asset has not been measured yet, not that it is playing well.

curl "https://api.brixsignage.com/v1/media/{id}/playback-quality" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 5XX Server error. The body carries a `requestId` to quote to support.

GET/v1/media/{id}/poster

Return the poster image attached to a media asset, used as its thumbnail for videos and PDFs.

curl "https://api.brixsignage.com/v1/media/{id}/poster" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id, or it has no poster.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/{id}/poster

Attach a poster image to a media asset, used as its thumbnail. The file must be an image and no larger than 4 MB. **Notes.** - With ?generate=1 the body is { thumbnailUrl, generated } and no request body is read.

curl -X POST "https://api.brixsignage.com/v1/media/{id}/poster" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id.

Response 413 Over 4 MB.

Response 415 Not a recognised image.

Response 422 Empty body.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/{id}/render

Capture and store a screenshot of a web or link asset. If screenshot rendering is not available for this workspace, the response reports that it is not configured rather than failing. **Notes.** - Usually queued (queued: true); the frame is then at GET /v1/media/{id}/render-frame.

curl -X POST "https://api.brixsignage.com/v1/media/{id}/render" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id.

Response 429 More than 60 renders a minute.

Response 502 The render failed.

Response 5XX Server error. The body carries a `requestId` to quote to support.

GET/v1/media/{id}/render-frame

Return the most recent screenshot generated for a web or link asset by the render operation.

curl "https://api.brixsignage.com/v1/media/{id}/render-frame" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id, or the link has not been rendered yet (a render is then queued).

Response 5XX Server error. The body carries a `requestId` to quote to support.

GET/v1/media/{id}/render-source

Read-only byte stream used to generate a video's poster image, with support for partial (Range) reads. Access is scoped to a single media asset and workspace and expires after two minutes. This is not a general-purpose way to download or stream media; use the media file operation for that.

curl "https://api.brixsignage.com/v1/media/{id}/render-source" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 4XX Client error. 404 rather than 403 for another tenant's resource, so account existence is not leaked.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/{id}/restore

Bring back a deleted media asset. Any playlist or screen still referencing it resumes rendering it.

curl -X POST "https://api.brixsignage.com/v1/media/{id}/restore" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id.

Response 409 `not_deleted`: it is not in the recycle bin.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/{id}/rotate

Rotate a photo or video 90, 180, or 270 degrees clockwise. This rewrites the stored file rather than only changing how it is displayed, since playback devices cannot rotate video at display time. Images are rotated immediately; video rotation is queued, and the asset keeps playing its current version until the rotated file is ready. **Notes.** - Photos rotate now (rotated); videos are re-encoded in the background (queued).

Request body application/json

curl -X POST "https://api.brixsignage.com/v1/media/{id}/rotate" \
  -H "Authorization: Bearer $BRIX_API_KEY" \
  -H "Content-Type: application/json"

Response 200 Success.

Response 400 `degrees` is not 90, 180 or 270, or the item is not a photo or video.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id, or its bytes are gone.

Response 409 A rotation is already running.

Response 502 The image service failed.

Response 503 Rotation is not available.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/{id}/suggest

Analyze an image asset and return suggested altText and tags. This only returns suggestions; it does not save them, so use the update-media-asset operation to accept them. Only images are supported. If this feature is temporarily unavailable, the response returns empty values rather than failing. **Notes.** - Suggestions only: nothing is saved.

curl -X POST "https://api.brixsignage.com/v1/media/{id}/suggest" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 400 `wrong_kind`: not an image.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id, or no bytes.

Response 413 Over 32 MB.

Response 5XX Server error. The body carries a `requestId` to quote to support.

GET/v1/media/{id}/usage

Return where a media asset is used, across playlists, creatives, and layouts, along with when it was last played.

curl "https://api.brixsignage.com/v1/media/{id}/usage" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No such asset in this workspace.

Response 5XX Server error. The body carries a `requestId` to quote to support.

PUT/v1/media/{id}/web-secrets

Store credentials, such as authentication tokens or login passwords, for a web asset. Values are encrypted at rest and write-only: send an object mapping reference names to values, where a null value deletes that reference. Only the reference names, never the values, can be read back later. This merges with any existing secrets rather than replacing them.

Request body application/json

curl -X PUT "https://api.brixsignage.com/v1/media/{id}/web-secrets" \
  -H "Authorization: Bearer $BRIX_API_KEY" \
  -H "Content-Type: application/json"

Response 200 Success.

Response 400 Too many secrets, or a name or value too long.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No media with this id.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/backfill-avif

Convert this workspace's existing AVIF image assets to JPEG.

Request body application/json

curl -X POST "https://api.brixsignage.com/v1/media/backfill-avif" \
  -H "Authorization: Bearer $BRIX_API_KEY" \
  -H "Content-Type: application/json"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 429 More than 10 runs a minute.

Response 503 `binding_absent`: image conversion is not available.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/backfill-codec-warnings

Recompute codec-compatibility warnings for this workspace's video assets under the current compatibility rules, and clear any outdated re-export warnings. Safe to run more than once.

curl -X POST "https://api.brixsignage.com/v1/media/backfill-codec-warnings" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 429 More than 10 runs a minute.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/backfill-heic

Convert this workspace's existing HEIC image assets to JPEG so they display correctly on devices that cannot decode HEIC. Safe to run more than once, and applies only to your own workspace. Returns a 503 error if the conversion feature is temporarily unavailable.

Request body application/json

curl -X POST "https://api.brixsignage.com/v1/media/backfill-heic" \
  -H "Authorization: Bearer $BRIX_API_KEY" \
  -H "Content-Type: application/json"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 429 More than 10 runs a minute.

Response 503 `binding_absent`: HEIC conversion is not available.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/backfill-video-metadata

Scan this workspace's existing video files to fill in missing width, height, and duration values, and correct codec information that was guessed from the filename. Also updates the codec-compatibility warning where applicable.

Request body application/json

curl -X POST "https://api.brixsignage.com/v1/media/backfill-video-metadata" \
  -H "Authorization: Bearer $BRIX_API_KEY" \
  -H "Content-Type: application/json"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 429 More than 10 runs a minute.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/import-url

Import a file from a remote URL into the media library. The API fetches the file server-side, checking that the URL does not point to a disallowed destination, stores its bytes, and creates the media asset record. This is the same path used by the upload_media_from_url tool. Fetches a public http(s) URL into the library. SVG is refused. **Notes.** - The response is the row as built for insert, not the GET shape: tags is a JSON string (not an array), sourceUrl is present but not stored, and most columns (state, fit, width, …) are absent. Read GET /v1/media/{id} for the settled asset.

Request body application/json

curl -X POST "https://api.brixsignage.com/v1/media/import-url" \
  -H "Authorization: Bearer $BRIX_API_KEY" \
  -H "Content-Type: application/json"

Response 201 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 413 `too_large`: the file is over the size limit for its kind.

Response 415 `unsupported_type`: SVG or an unknown content type.

Response 422 Missing or non-http URL, a blocked address (`url_blocked`), or an unknown folder or location.

Response 502 `fetch_failed` / `source_status`: the source did not answer with the file.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/moderate

Run a safety classifier over a piece of user-submitted text, such as banner copy or a message board post, and return its verdict. This operation only classifies the text; it does not store it.

Request body application/json

curl -X POST "https://api.brixsignage.com/v1/media/moderate" \
  -H "Authorization: Bearer $BRIX_API_KEY" \
  -H "Content-Type: application/json"

Response 200 Success.

Response 400 `text` is missing.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 5XX Server error. The body carries a `requestId` to quote to support.

GET/v1/media/stats

Return summary counts for the media library in one response: total assets, unused assets, and a count per folder. Use this instead of listing all media when only summary counts are needed.

curl "https://api.brixsignage.com/v1/media/stats" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/media/upload

Upload a file in a single request using multipart form data. Accepts form fields file (required), and optional name, nodeId, and folderId. This stores the file and creates the media asset record in one step, and is safe to retry with the same Idempotency-Key header. For large files or programmatic clients, minting an upload URL and then uploading with PUT is usually simpler. **Notes.** - Form fields other than file are strings, as multipart sends them. - For files over ~100 MB use the multipart upload.

Request body multipart/form-data

curl -X POST "https://api.brixsignage.com/v1/media/upload" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 201 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 The folder or location does not exist.

Response 413 The file is over the limit for its kind (images 250 MB, video 2 GB, documents 100 MB, fonts 10 MB).

Response 415 SVG, or a type the library does not take.

Response 422 `file` is missing.

Response 5XX Server error. The body carries a `requestId` to quote to support.

PUT/v1/media/upload/{uploadId}

Upload the raw file bytes for a previously created upload slot. Send the file as the request body and set the Content-Type header to match the file's type. After uploading, finalize the upload to create the media asset record. **Notes.** - This stores the bytes for a bulk import; the import itself creates the media rows.

curl -X PUT "https://api.brixsignage.com/v1/media/upload/{uploadId}" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No mint with this id in this workspace.

Response 413 Over 500 MB.

Response 415 SVG.

Response 422 Empty body or a malformed id.

Response 5XX Server error. The body carries a `requestId` to quote to support.

GET/v1/media/upload/multipart/{id}

Return the state of an in-progress multipart upload, including the file's name, size, kind, part size, and every part already received, each with its part number, ETag, and size. Use this to resume an interrupted upload from the last completed part instead of starting over. Returns 404 if the upload belongs to another workspace, has already finished, or has expired.

curl "https://api.brixsignage.com/v1/media/upload/multipart/{id}" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No such upload.

Response 5XX Server error. The body carries a `requestId` to quote to support.