Gallery

Browse one page of your images and videos with short-lived links

The paged, link-carrying form of GET /v1/gallery, built for viewers such as the MCP show_gallery tool. This call is free: no credits are charged, no model is called and no bytes are returned. Every item carries presigned URLs that expire after 15 minutes.

  • thumbnail_url opens a small stored thumbnail (or, for a video, its poster) inline.
  • view_url opens the original image, or plays the video, inline; download_url saves it.
  • Every URL is a credential for 15 minutes: anyone holding it can read the file. Do not log it or pass it on.
  • An item stored only on the server disk, or one that cannot be presigned right now, is still listed, with its link fields null, so page sizes and offsets stay stable.

The category is intersected with the containers your token can read: a token holding only images:read never sees videos, whatever it asks for. A literal path, so it is never read as GET /v1/gallery/{uuid}.

get/v1/gallery/browse

Request

  • Base URL: https://contentmaschine.ai/api
  • URL: https://contentmaschine.ai/api/v1/gallery/browse
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://contentmaschine.ai/api/oauth/authorize, token URL https://contentmaschine.ai/api/oauth/token)

Query parameters

category'images' | 'videos' | 'all'

Anything else, including the singular forms, is a 400.

limitinteger

Items per page. A non-integer is a 400.

offsetinteger

Items to skip. A negative or non-integer value is a 400.

Response

One page of items with 15-minute links.

successboolean
timestampstring date-time

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.