Upload product document
Upload a single PDF document and attach it to the product. Non-PDF uploads are rejected with 422. PDF metadata (page count, thumbnail) is extracted asynchronously after upload, so those fields may be null in the immediate response. Requires the organization.contribute_organization permission on the membership.
Authorizations
Path Parameters
UUID of the organization that owns the product.
22^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$GTIN-8/12/13/14 of the target product. Normalized to GTIN-14 by zero-padding before lookup.
^\d{8,14}$Body
Response
Created
A single PDF document attached to a product.
URL-safe 22-character shortuuid encoding of the row's UUID primary key. Stable across the row's lifetime; suitable for sharing in URLs, log lines, and external SDK clients. Accepted on input as either the shortuuid form or the canonical UUID form (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
22^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$Caption entered for the document. Empty string when not set.
255"Safety Data Sheet"
Free-text description of the document. Empty string when not set.
Best available title: the entered title, else the PDF's embedded title, else the filename.
"Safety Data Sheet"
ISO-8601 UTC timestamp of when the document was uploaded.
Absolute URL of the stored PDF. Null only when the underlying file is missing.
"https://cdn.closient.com/products/00012345678905/sds.pdf"
Number of pages, extracted asynchronously after upload. Null until the PDF-processing task has run.
x >= 0Size of the stored file in bytes. Null when not yet computed.
x >= 0URL of the first-page thumbnail, generated asynchronously. Empty string / null until processing has run.