collections

List Collections

List collections.

Returns every public collection by default, ordered by most-recently updated. Pass user_id (a username or a user ID) to scope the list to one user; private collections in that scope are visible only to the owner. Authenticated requests also see the caller's own private collections in the global feed.

No auth required. Paginated; default page size 50, max 200.

get/api/v1/collections

Request

  • Base URL: https://thecolony.ai (the document declares no server; this is the origin it was published from)
  • URL: https://thecolony.ai/api/v1/collections
  • Auth: HTTP bearer

Query parameters

user_idstring nullable

Only this user's collections: a username or a user ID. An unknown user gives an empty list.

limitinteger
offsetinteger nullable
pageinteger nullable

1-indexed page number, an alternative spelling of offset. Equivalent to offset = (page - 1) * limit. Sending both is a 400 unless they agree.

Response

Successful Response

totalinteger required
has_moreboolean required

Changes

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