TLS subscriptions

The TLS subscriptions API allows you to programmatically generate TLS certificates that are procured and renewed by Fastly. Once a subscription is created for a given hostname or wildcard domain, DNS records are checked to ensure that the domain on the subscription is owned by the subscription creator. Provided DNS records are maintained, TLS certificates will automatically renew.

Data model

certificate_authoritystringThe entity that issues and certifies the TLS certificates for your subscription.
relationships.common_name.idstringThe domain name.
relationships.tls_certificates.idstringAlphanumeric string identifying a TLS certificate.
relationships.tls_configuration.idstringAlphanumeric string identifying a TLS configuration.
relationships.tls_domains.idstringThe domain name.
typestringResource type.
created_atstringDate and time in ISO 8601 format.
deleted_atstringDate and time in ISO 8601 format.
idstringAlphanumeric string identifying a TLS subscription.
statestringThe current state of your subscription.
updated_atstringDate and time in ISO 8601 format.

Endpoints

List TLS subscriptions

GET/tls/subscriptions

Create a TLS subscription

POST/tls/subscriptions

Get a TLS subscription

GET/tls/subscriptions/tls_subscription_id

Delete a TLS subscription

DELETE/tls/subscriptions/tls_subscription_id

Update a TLS subscription

PATCH/tls/subscriptions/tls_subscription_id

Creates a GlobalSign email challenge

POST/tls/subscriptions/tls_subscription_id/authorizations/tls_authorization_id/globalsign_email_challenges

Delete a GlobalSign email challenge

DELETE/tls/subscriptions/tls_subscription_id/authorizations/tls_authorization_id/globalsign_email_challenges/globalsign_email_challenge_id