collections

List Collections by Publication URL

View as Markdown
List collections for a publication identified by its custom URL. Supports filtering, searching, and pagination. Access control is enforced based on publication visibility: - **PUBLIC:** Anonymous access allowed, returns all PUBLIC collections - **TEAM:** Requires authentication and workspace membership, returns all collections - **PRIVATE:** Requires authentication, workspace membership, and appropriate role Request body should contain 'url' (required) plus optional filter parameters.

Request

This endpoint expects an object.
urlstringRequired

Publication custom URL (required)

searchstringOptional
Search collections by name or description
visibilityenumOptional
Filter by visibility
Allowed values:
tagsstringOptional

Comma-separated tag names to filter by

ownerstringOptional
Filter by owner ID or username

Response

List of collections with pagination
countinteger
resultslist of objects
nextstring or nullformat: "uri"
previousstring or nullformat: "uri"

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error