List collections
Returns all your collections with titles, descriptions, and item counts.
Scope: read
Response 200
Get collection
Returns a single collection with its full metadata.
Scope: read
Response 200
Create collection
Create a new collection.
Scope: write
Collection title (1-40 characters).
Short description (up to 500 characters).
Emoji icon for the collection.
Response: 201 Created
Returns the created collection in the same shape as get collection.
Update collection
Update a collection’s title, description, or icon. All fields are optional.
Scope: write
Response: 200
Returns the updated collection in the same shape as get collection.
Delete collection
Permanently delete a collection. Content items in the collection are not deleted.
Scope: write
Response: 204 No Content
List collection items
Returns content items within a specific collection.
Scope: read
Response 200
Each item wraps the content inside a content field, alongside collection-specific metadata like position and addedAt.
Add item to collection
Add a content item to a collection.
Scope: write
The content item ID to add.
Optional position in the collection ordering.
Response: 201 Created
Remove item from collection
Remove a content item from a collection. The content itself is not deleted.
Scope: write
Response: 204 No Content