Collection items

Add an item (published unless status is draft)

Requires the collections:write scope (add, edit, reorder, and delete collection items). Send Idempotency-Key to retry safely: a repeat with the same key and body within 24 hours returns the first response.

post/v1/collections/{collectionId}/items

Request

  • Base URL: https://api.dropl.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.dropl.io/v1/collections/{collectionId}/items
  • Auth: HTTP bearer

Path parameters

collectionIdstring uuid required

Headers

Idempotency-Keystring

Unique per request, up to 255 printable ASCII characters. Reusing it with a different request is a 422.

Request body

valuesCollectionItemValues required

Field key → value. Prices are { amount, currency }; image fields hold photo ids from this collection's media uploads.

status'draft' | 'published'
slugstring

Response

Success

mediaCollectionMedia required

Photo id → preview for the images the items reference.

Changes

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