Skip to content
Cloudflare API
Start here
API Reference

Certificate Authorities

Certificate AuthoritiesHostname 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.