/v1/communities/{community_id}/collections/{collection_id}/itemsAuthAdd a post to a collection (owner only). Idempotent per (collection, post).
Path parameters
community_id*stringSocial community UUID.
collection_id*string · uuidId of the collection.
Headers
Idempotency-KeystringOpaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.
Request body
actor_idstring · uuidThe acting actor; must be the collection owner. Send it, or the deprecated `caller_actor_id`; one of the two is required.
Example: "aaaaaaaa-0000-0000-0000-000000000001"
caller_actor_idstring · uuidDeprecated alias of `actor_id`; send `actor_id`.
Example: "aaaaaaaa-0000-0000-0000-000000000001"
post_id*string · uuidThe post to add.
Example: "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"
positionnumberCurator ordering position.
Response · 201 Item added (or already present).
collection_id*string · uuidId of the collection.
Example: "99999999-0000-0000-0000-000000000001"
post_id*string · uuidId of the post in the collection.
Example: "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"
community_id*string · uuidId of the community.
Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"
position*numberOwner-defined ordering position.
Example: 0
added_at*string · date-timeWhen the post was added.
Example: "2026-05-01T12:00:00.000Z"
Example
Request
POST https://social.productcraft.co/v1/communities/{community_id}/collections/{collection_id}/items
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
"caller_actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
"post_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
"position": 0
}Response
{
"collection_id": "99999999-0000-0000-0000-000000000001",
"post_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
"community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
"position": 0,
"added_at": "2026-05-01T12:00:00.000Z"
}