Sign in
internal

Update SSL status

Changed on

Webhook endpoint for Caddy plugin to update SSL status.

Internal webhook called by Caddy when SSL certificates are issued or updated. Requires X-Gateway-Secret header for authentication.

See also:.*

post/internal/websites/{domain}/ssl-status

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /internal/websites/{domain}/ssl-status
  • Auth: none declared

Path parameters

domainstring required

Domain name for the website. Example: example.com

Request body

errorstring
statusstring required
timestampstring

Response

SSL status updated

active_cidstring
createdstring date-time required
dns_hosting_enabledboolean required
domainstring required
expiredboolean required
gateway_domainstring
idinteger required
ipns_key_idinteger
is_subdomainboolean required
last_checked_atstring date-time
statusstring required
target_hashstring required
target_typestring required
updatedstring date-time required
validation_expires_atstring date-time
validation_record_hoststring
validation_tokenstring required
zone_idinteger

Changes

  • 06e0fa4f446eRevision changes
    • warning

      removed the optional property from the response with the status

    • warning

      added the new failed enum value to the / response property for the response status

    • warning

      added the new issuing enum value to the / response property for the response status

    • warning

      added the new pending enum value to the / response property for the response status

    • warning

      added the new ready enum value to the / response property for the response status

    • info

      added the optional property to the response with the status

  • b97dd0465ab3Revision changes
    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status