Brix

Brix Media API

The media API from Brix — 36 operation(s) for media.

GitHub OpenAPI

Operations 42

GET /v1/media List media #
POST /v1/media Create a media item #
DELETE /v1/media/{id} Delete a media asset #
GET /v1/media/{id} Get a media asset #
PATCH /v1/media/{id} Update a media asset #
GET /v1/media/{id}/captions Get a video's captions #
POST /v1/media/{id}/captions Generate captions for a video #
POST /v1/media/{id}/captions/transcribe Generate captions from a video's audio #
POST /v1/media/{id}/captions/upload Upload a caption file #
POST /v1/media/{id}/captions/visibility Show or hide a video's captions #
GET /v1/media/{id}/delta Check for a media delta download #
GET /v1/media/{id}/file Download a media file #
POST /v1/media/{id}/focal-region Detect an image's focal region #
GET /v1/media/{id}/lan-preview The on-network page preview state: the newest picture a screen took ({url… #
POST /v1/media/{id}/lan-preview Ask a screen for a picture of an ON-NETWORK web page (webConfig.localOnly) the… #
GET /v1/media/{id}/lan-preview/file Stream the newest screen-taken picture of an on-network page (R2… #
GET /v1/media/{id}/playback-quality Get a video's playback quality #
GET /v1/media/{id}/poster Get a media poster image #
POST /v1/media/{id}/poster Set or generate a media poster #
POST /v1/media/{id}/render Render a web link now #
GET /v1/media/{id}/render-frame Get a web link's latest render #
POST /v1/media/{id}/restore Restore a deleted media item #
POST /v1/media/{id}/rotate Rotate a photo or video #
POST /v1/media/{id}/suggest Suggest alt text and tags for an image #
GET /v1/media/{id}/usage Show where a media asset is used #
PUT /v1/media/{id}/web-secrets Set a web link's secrets #
POST /v1/media/backfill-avif Convert AVIF images #
POST /v1/media/backfill-codec-warnings Re-check codec warnings #
POST /v1/media/backfill-heic Convert HEIC images #
POST /v1/media/backfill-video-metadata Fill in missing video details #
POST /v1/media/bulk-delete Soft-delete up to 500 media assets in one call; per-id permission, share check… #
POST /v1/media/import-url Import media from a URL #
POST /v1/media/moderate Check text for unsafe content #
GET /v1/media/stats Get media library statistics #
POST /v1/media/upload Upload a media file #
PUT /v1/media/upload/{uploadId} Upload bytes to a minted upload URL #
GET /v1/media/upload/multipart/{id} Get a multipart upload's progress #
POST /v1/media/upload/multipart/{id}/abort Cancel a multipart upload #
POST /v1/media/upload/multipart/{id}/complete Complete a multipart upload #
PUT /v1/media/upload/multipart/{id}/part/{partNumber} Upload one part of a multipart upload #
POST /v1/media/upload/multipart/create Start a multipart upload #
POST /v1/media/upload/package Upload an HTML5 package #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/brixsignage-com/openapi/brixsignage-com-media-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/brixsignage-com/json-schema/brixsignage-com-screen-schema.json
📊
JSONSchema
https://artifacts.apis.io/brixsignage-com/json-schema/brixsignage-com-media-asset-detail-schema.json
📊
JSONSchema
https://artifacts.apis.io/brixsignage-com/json-schema/brixsignage-com-media-asset-schema.json
📊
JSONSchema
https://artifacts.apis.io/brixsignage-com/json-schema/brixsignage-com-manifest-preview-schema.json
📊
JSONSchema
https://artifacts.apis.io/brixsignage-com/json-schema/brixsignage-com-media-asset-updated-schema.json
📊
JSONSchema
https://artifacts.apis.io/brixsignage-com/json-schema/brixsignage-com-workspace-prefs-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/brixsignage-com:brixsignage-com-media-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

brixsignage-com-media-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Brix Media API
  version: '1'
  summary: 'Control plane for Brix digital signage: screens, content, playlists, schedules, casts and emergencies.'
  description: 'Generated from the route table the API actually mounts

    (`apps/api/routes.snapshot.json`), the description each route is required to

    carry (`tests/contracts/route-registry.json`), and request/response schemas

    (`apps/api/src/openapi/`). CI enforces all three, so this document cannot list a

    route that does not exist or omit one that does.


    **Schemas.** 447 operations carry request and response schemas

    (`x-brix-schema: verified`). Each is checked in CI against the response the

    real handler returns — a missing, mistyped or undeclared field fails the build.

    The remaining operations are route-level only (`x-brix-schema: none`): their

    path, method, permission and purpose are exact, but the shape of `data` is not

    yet modelled, and we would rather say so than publish a schema that validates

    against nothing. Objects are open: a new field is not a breaking change.


    **Envelope.** Success bodies are `{ "data": … }`. Failures are

    `{ "error": "", "message": "…" }`, plus `requestId` on a 5xx.

    Many list routes page opt-in (see each operation): pass `?limit=` and

    follow `nextCursor` via `?cursor=` until it is null.


    **Authentication.** `Authorization: Bearer ` with an API key

    (`ak_…`, created in the console under Settings → API & MCP) or a user session. An

    API key carries a creator-chosen set of `resource.verb` permissions and may be

    pinned to one location''s subtree; a key can never be granted a permission its

    creator does not hold. The permission an operation needs is in

    `x-brix-permission` and in its security requirement.


    **Tenancy.** Every request resolves to one workspace. A resource belonging to

    another tenant returns 404, never 403, so a response never confirms that an

    account exists.


    **Rate limits.** A 429 carries `Retry-After`; a 503 `database_busy` means retry

    after the `Retry-After` interval.'
servers:
- url: https://api.brixsignage.com
  description: Production
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (184 KB total) ---
# Full source: https://artifacts.apis.io/brixsignage-com/openapi/brixsignage-com-media-api-openapi.yml