API Reference

Certificate Authorities

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Hostname Associations

List Hostname Associations

GET/zones/{zone_id}/certificate_authorities/hostname_associations

Replace Hostname Associations

PUT/zones/{zone_id}/certificate_authorities/hostname_associations

ModelsExpand Collapse

TLSHostnameAssociation object { hostnames, mtls_certificate_id }

hostnames: optional array of string

Unordered set of hostnames. Hostnames are stored as lowercase punycode.

mtls_certificate_id: optional string

The UUID for a certificate that was uploaded to the mTLS Certificate Management endpoint. If no mtls_certificate_id is given, the hostnames will be associated to your active Cloudflare Managed CA.

maxLength36

minLength36

HostnameAssociationGetResponse object { hostnames }

hostnames: optional array of string

Hostnames are returned in lowercase punycode, in no particular order. Null when there are no associations.

HostnameAssociationUpdateResponse object { hostnames }

hostnames: optional array of string

Hostnames are returned in lowercase punycode, in no particular order. Null when there are no associations.