Projects

Add a project (up to 100)

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/showcases/{showcaseId}/projects

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}/projects
  • Auth: HTTP bearer

Path parameters

showcaseIdstring 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
subtitlestring nullable

E.g. the location.

descriptionstring nullable
slugstring

Used in project links; derived from the title when omitted.

detailsobject

Detail key to value: numbers for number and year, YYYY-MM-DD for date, an option value (or label) for select. null clears one.

categoryIdsstring[]

Response

Success

idstring uuid required
slugstring required
titlestring required
subtitlestring nullable required
descriptionstring nullable required
coverImageIdstring uuid nullable required

The chosen cover; null uses the first ready photo.

coverUrlstring nullable required
positioninteger required
detailsobject required
categoryIdsstring[] required
itemCountinteger required
readyItemCountinteger required

The project shows on the website once it has a public item.

createdAtstring date-time required
updatedAtstring date-time required

Changes

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