Showcases

Set an item's alt text and categories

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

patch/v1/showcases/{showcaseId}/items/{itemId}

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

Path parameters

showcaseIdstring uuid required
itemIdstring uuid required

Request body

altTextstring nullable

What the photo shows, for screen readers and search engines (e.g. "Cedar deck with glass railing"). Line breaks and invisible characters are removed; null or empty marks the photo decorative.

addCategoryIdsstring[]
removeCategoryIdsstring[]

Response

Success

idstring uuid required
kind'photo' | 'video' required
status'uploading' | 'processing' | 'ready' | 'failed' required
failureReasonstring nullable required
positioninteger required
altTextstring nullable required
widthinteger nullable required
heightinteger nullable required
placeholderColorstring nullable required
previewUrlstring nullable required
largeUrlstring nullable required
sourceFileNamestring nullable required
categoryIdsstring[] required
projectIdstring uuid nullable required

The project the item belongs to (projects showcases).

createdAtstring date-time required

Changes

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