Showcases

Add library videos from the same site

Requires the showcases:write scope (create and edit showcases, categories, and tags).

post/v1/showcases/{showcaseId}/videos

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/showcases/{showcaseId}/videos
  • Auth: HTTP bearer

Path parameters

showcaseIdstring uuid required

Request body

videoIdsstring[] required
projectIdstring uuid

Required in projects showcases.

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.