Projects

Change a project's text, link name, cover, details, or categories

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

patch/v1/showcases/{showcaseId}/projects/{projectId}

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

Path parameters

showcaseIdstring uuid required
projectIdstring uuid required

Request body

titlestring
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[]
coverImageIdstring uuid nullable

A photo in this project, or null for the first ready photo.

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.