{ "opencollection": "1.0.0", "info": { "name": "Hetzner Cloud Actions Certificates API", "version": "1.0.0" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "Certificates", "type": "folder" }, "items": [ { "info": { "name": "List Certificates", "type": "http" }, "http": { "method": "GET", "url": "https://api.hetzner.cloud/v1/certificates", "params": [ { "name": "sort", "value": "", "type": "query", "description": "Sort resources by field and direction. May be used multiple times.\n\nFor more information, see \"[Sorting](#description/sorting)\".\n" }, { "name": "name", "value": "", "type": "query", "description": "Filter resources by their name.\n\nThe response will only contain the resources\nmatching exactly the specified name.\n" }, { "name": "label_selector", "value": "", "type": "query", "description": "Filter resources by labels.\n\nThe response will only contain resources matching the label selector.\nFor more information, see \"[Label Selector](#description/label-selector)\".\n" }, { "name": "type", "value": "", "type": "query", "description": "Filter resources by type. May be used multiple times.\n\nThe response will only contain the resources with the specified type.\n" }, { "name": "page", "value": "", "type": "query", "description": "Page number to return. For more information, see \"[Pagination](#description/pagination)\"." }, { "name": "per_page", "value": "", "type": "query", "description": "Maximum number of entries returned per page. For more information, see \"[Pagination](#description/pagination)\"." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Returns all Certificate objects.\n" }, { "info": { "name": "Create a Certificate", "type": "http" }, "http": { "method": "POST", "url": "https://api.hetzner.cloud/v1/certificates", "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Creates a new Certificate.\n\nThe default type **uploaded** allows for uploading your existing `certificate` and `private_key` in PEM format. You have to monitor its expiration date and handle renewal yourself.\n\nIn contrast, type **managed** requests a new Certificate from *Let's Encrypt* for the specified `domain_names`. Only domains managed by *Hetzner DNS* are supported. We handle renewal and timely alert the project owner via email if problems occur.\n\nFor type `managed` Certificates the `actio" }, { "info": { "name": "Get a Certificate", "type": "http" }, "http": { "method": "GET", "url": "https://api.hetzner.cloud/v1/certificates/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "ID of the Certificate." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Gets a specific Certificate object.\n" }, { "info": { "name": "Update a Certificate", "type": "http" }, "http": { "method": "PUT", "url": "https://api.hetzner.cloud/v1/certificates/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "ID of the Certificate." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Updates the Certificate properties.\n\nNote: if the Certificate object changes during the request, the response will be a “conflict” error.\n" }, { "info": { "name": "Delete a Certificate", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.hetzner.cloud/v1/certificates/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "ID of the Certificate." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Deletes a Certificate.\n" } ] } ], "bundled": true }