v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-016280256.4 KB
libraries

List libraries

Returns libraries owned by the authenticated user (no pagination — users typically have one or a handful). Call this when another tool's library_id parameter is required but you don't yet know which libraries exist. A single-library user can usually omit library_id on other tools entirely.

By default trashed libraries are excluded. Pass state=trashed to list the trash drawer (ordered by most recently trashed) or state=all for both.

get/api/libraries

Query parameters

state'live' | 'trashed' | 'all'

Which set of libraries to return: live (default — excludes trashed), trashed (only trashed, ordered by most recently trashed), or all (both).

Which set of libraries to return: live (default — excludes trashed), trashed (only trashed, ordered by most recently trashed), or all (both).

Response

Successful Response

idstring required

Unique library identifier with 'lib_' prefix

namestring required

Display name of the library

descriptionstring nullable

Optional description text for the library

user_idstring required

ID of the user who owns this library

asset_countinteger required

Total number of assets in this library

storage_used_bytesinteger required

Bytes of assets currently stored in this library

storage_limit_bytesinteger nullable

Maximum bytes this library may store, or null if no per-library limit applies

created_atstring date-time required

When this library was created

updated_atstring date-time required

When this library was last updated