Docs

API reference · Zones

List the names the edge serves for a zone

GET/v1/orgs/{org}/zones/{zone}/hostnames
Permission
zones.hostnames.read
Operation
zones.hostnames.list

Parameters

NameInTypeRequiredNotes
orgpathstringyesfor example "org_01h455vb4pex5vsknk084sn02q"
zonepathstringyesfor example "zone_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"

Response 200

FieldTypeRequiredNotes
itemsarray of objectyes
items[].idstringyesfor example "hostname_01h455vb4pex5vsknk084sn02q"
items[].zoneIdstringyesfor example "zone_01h455vb4pex5vsknk084sn02q"
items[].namestringyes
items[].certificateRequestedbooleanyes
items[].edgeServingbooleanyes
items[].proxyDnsbooleanyes
items[].revisionstringyesOpaque revision: dot-joined counters.
items[].cnameTargetstring or nullyes
items[].createdAtstring (date-time)yesUTC, ISO 8601.