Showcases

Create a showcase

Requires the showcases:write scope (create and edit showcases, categories, and tags). 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}/showcases

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}/showcases
  • 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

titlestring required
type'gallery' | 'projects'

gallery: one grid of photos and videos. projects: a portfolio of projects, each with its own page. Changes only while the showcase is empty (409 SHOWCASE_NOT_EMPTY).

layout'grid' | 'collage'
gridFit'cover' | 'contain'
showCategoryFiltersboolean
pageSizeinteger nullable

Response

Success

idstring uuid required
publicIdstring required
titlestring required
type'gallery' | 'projects' required

gallery: one grid of photos and videos. projects: a portfolio of projects, each with its own page.

layout'grid' | 'collage' required
readyImageCountinteger required
itemCountinteger required
videoCountinteger required
projectCountinteger required
coverUrlstring nullable required
isPrivateboolean required

Private client photos (e.g. "Photos from feedback"): never public, and the embed endpoint answers 409 SHOWCASE_PRIVATE.

createdAtstring date-time required
updatedAtstring date-time required
deletedAtstring date-time nullable required
workspaceIdstring uuid required
purgeAfterstring date-time nullable required
gridFit'cover' | 'contain' required
showCategoryFiltersboolean required
pageSizeinteger nullable required
projectDetailsVersioninteger required

Changes

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