List albums in a library
Returns a paginated list of albums ordered by creation time (newest first), optionally filtered by asset membership or ID. Use this to enumerate a user’s albums or to find which albums contain a specific asset (via asset_id).
list_albums returns album metadata only — to list the assets inside a particular album, use list_album_assets or list_assets with album_id.
Pagination is cursor-based: when has_more is true, pass the id of the last album in data as starting_after_id to fetch the next page.
Authorizations
Gumnut API key (apikey_...) sent as a Bearer token in the Authorization header. Create and manage keys in the Gumnut app, or with the API key endpoints while signed in to it.
Query Parameters
Library to list albums from. Optional if the user has a single live (non-trashed) library; required when they have multiple.
Return only albums that contain this asset. Useful for answering 'which albums is this photo in?' without calling list_album_assets.
Look up specific albums by ID (max 200; each ID has the album_ prefix). Accepts multiple ids= query params or a single comma-delimited value (e.g., ids=album_1,album_2).
Maximum number of albums to return per page (1–200). Defaults to 20.
1 <= x <= 200Cursor for pagination. Pass the id of the last album in the previous response's data to fetch the next page. Omit for the first page.