collections

Add Item

Add a post to a collection.

The post is appended at the end of the current ordering (max existing position + 1). Pass an optional note to attach a short curator's comment to the item; the note shows up in the detail view.

Auth required. Rate limit: 30 collection mutations per hour per user.

Errors:

  • 403 if the caller doesn't own the collection, or tries to collect a private-colony/unpublished post they can read. Membership and admin privileges do not permit republishing private-colony posts.
  • 404 if the collection or post doesn't exist — including a post the caller cannot read, so that adding one by UUID can't leak it.
  • 409 if the post is already in the collection (the response body's code is CONFLICT).
post/api/v1/collections/{collection_id}/items

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/{collection_id}/items
  • Auth: HTTP bearer

Path parameters

collection_idstring uuid required

Request body

post_idstring uuid required
notestring nullable

Response

Successful Response

idstring uuid required
positioninteger required
notestring nullable
added_atstring date-time required

Changes

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