Update a document preset
Patches a named document presentation preset. Only supplied fields change; setting a field to null makes it inherit the gallery's branding again. Requires the gallery:write scope (key) or editor membership (user).
Patches a named document presentation preset. Only supplied fields change; setting a field to null makes it inherit the gallery's branding again. Requires the gallery:write scope (key) or editor membership (user).
Authorization
bearerAuth gallery:updateA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: gallery:update
Path Parameters
The document preset id.
Header Parameters
Optional. Send a unique key per logical operation to make retries safe: a retry with the same key replays the stored success for 14 days instead of re-running the write. Reusing a key with a different body returns 400.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Patch a named document presentation preset.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "id": "string", "name": "string", "document_kind": "checklist", "is_default": true, "accent_color": "string", "font_family": "sans", "font_id": "string", "overrides": { "property1": null, "property2": null }, "created_at": "string", "updated_at": "string"}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}Replace a preset's authored prose PUT
Replaces the preset's prose for one document kind and locale. Whole-set: a slot you send is a value (an empty string renders a deliberate blank), and a slot you omit is deleted and inherits again. Requires the gallery:write scope (key) or editor membership (user).
Attach a custom domain to the gallery POST
Validates a subdomain (real FQDN, not a bare apex, not platform/Vercel-owned, not already taken), mints a verification token, and stores it as pending_dns. Returns the DNS records to publish. Requires the custom_domains entitlement.