List your collections
Every collection your assets are in, one row each: the name, how many assets are in it and when the latest one was created — most recently added to first. count is the total GET /api/v1/assets?collection= reports for that name. q narrows the list to names containing it, case-insensitively. A chain job's intermediates are not counted and their job: collections are not listed.
USE THIS WHEN:
- Finding out which collections exist before filtering or submitting into one
- Checking a collection name's spelling (a misspelt name is simply a new collection)
DO NOT USE WHEN:
- Listing the assets in a collection → use GET /api/v1/assets?collection=
Request
- Base URL: https://api.imagestep.dev
- URL: https://api.imagestep.dev/api/v1/assets/collections
- Auth: API key in header Authorization
Query parameters
Only names containing this text (case-insensitive)
Page number (0-indexed). Leave it out when you send cursor
Items per page (max 100; out of range is clamped)
The meta.nextCursor of the previous page: the rows after it, read without counting — the way to walk a long listing. Send it unchanged, with the same filters; it cannot be combined with page
Response
One page of collections; meta carries hasMore and nextCursor
Changes
No recorded changes to this operation across all 1 revision of this API.