Library

List library items (transcriptions, uploads, documents)

The Library view: the things the gallery does not cover. Items are filtered to the containers your token can read. A token holding no readable container gets an empty list with a 200, never a 403 - the route gate already ran and this is a view filter, not an access denial.

counts holds the real totals of your library per item type, independent of limit, offset and type. It only counts items in containers your token can read, so it cannot leak the existence of the others. pagination.has_more tells whether more items follow this page, measured BEFORE container filtering. With type=all the three item types are merged, newest change first, and paged as one list.

The route-level scope is an any-of list (text:read, audio:read, files:read) and is a coarse pre-filter, not the boundary. The per-item container check is.

get/v1/library

Request

  • Base URL: https://contentmaschine.ai/api
  • URL: https://contentmaschine.ai/api/v1/library
  • 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

type'all' | 'transcription' | 'upload' | 'document'

Anything else is a 400.

limitinteger

Clamped, not rejected.

offsetinteger

Response

The filtered page.

successboolean
timestampstring date-time

Example response

{
  "success": true
}

Changes

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