Docs

API reference · Static hosting

Change a static site's optimization settings; they apply from its next deployment on

PATCH/v1/orgs/{org}/zones/{zone}/origins/{origin}/optimization
Permission
hosting.optimization.manage
Budget
60 requests in 60 s per organization, shared as hosting.changes
Audit log
hosting.optimization.update
Operation
hosting.optimization.update

Parameters

NameInTypeRequiredNotes
orgpathstringyesfor example "org_01h455vb4pex5vsknk084sn02q"
zonepathstringyesfor example "zone_01h455vb4pex5vsknk084sn02q"
originpathstringyesfor example "origin_01h455vb4pex5vsknk084sn02q"
Idempotency-KeyheaderstringnoOne key per intended mutation. A retry with the key replays the recorded response instead of executing again; the key with another request answers 422 idempotency_key_reused. For example "01h455vb4pex5vsknk084sn02q"
x-obhut-management-assignmentheaderstringnoSelect one staff assignment. Direct membership remains the default. Bound API tokens use their stored source and ignore this selector. For example "masg_01h455vb4pex5vsknk084sn02q"

Request body

FieldTypeRequiredNotes
fontsbooleanno
metadatabooleanno
speculationbooleanno

Response 200

FieldTypeRequiredNotes
fontsbooleanyes
metadatabooleanyes
speculationbooleanyes