Collections

Create a collection from a template, custom fields, or blank

Requires the collections:schema scope (create collections and change their fields (structure)). Send Idempotency-Key to retry safely: a repeat with the same key and body within 24 hours returns the first response.

post/v1/sites/{siteId}/collections

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/sites/{siteId}/collections
  • Auth: HTTP bearer

Path parameters

siteIdstring 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

namestring required
slugstring
descriptionstring nullable
templateKey'menu' | 'inventory' | 'events' nullable
titleFieldKeystring
visibility'public' | 'private'

Response

Success

idstring uuid required
publicIdstring required
workspaceIdstring uuid required
namestring required
slugstring required
descriptionstring nullable required
templateKey'menu' | 'inventory' | 'events' nullable required
visibility'public' | 'private' required
itemCountinteger required
publishedItemCountinteger required
titleFieldKeystring required
createdAtstring date-time required
updatedAtstring date-time required
deletedAtstring date-time nullable required
purgeAfterstring date-time nullable required
lastPublicReadAtstring date-time nullable required
schemaVersioninteger required
timezonestring required
publicItemsUrlstring uri nullable required

Public read endpoint for websites (published items only); null when private.

canEditSchemaboolean required

Changes

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