infomaniak_request_certificate
Destructive
Request or renew SSL certificates for your website on a web hosting. Supports free Let's Encrypt, paid Sectigo, or custom PEM certificates.
Instructions
Request a new SSL certificate (or re-issue / renew an existing one) for a site on a web hosting. Two-phase commit. Three types supported: free (Let's Encrypt, no extra fields), paid (Sectigo, requires certificate_id), custom (BYO PEM, requires certificate + private_key). Returns an operation_uuid; poll infomaniak_get_certificate to track progress.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hosting_id | Yes | Web hosting ID. Discover via infomaniak_find_site(domain) → hosting_id. | |
| site_id | Yes | Site ID on that hosting. Same source as hosting_id. | |
| type | Yes | Certificate kind: `free` (Let's Encrypt, no extra fields), `paid` (pre-purchased Sectigo, requires `certificate_id`), `custom` (bring-your-own PEM, requires `certificate` + `private_key`). Default workflow: `free`. | |
| certificate_id | No | Pre-purchased certificate ID. REQUIRED when type=`paid`, ignored otherwise. | |
| certificate | No | PEM-encoded leaf certificate. REQUIRED when type=`custom`, ignored otherwise. Multi-line string starting with `-----BEGIN CERTIFICATE-----`. | |
| private_key | No | PEM-encoded private key matching `certificate`. REQUIRED when type=`custom`. Multi-line string starting with `-----BEGIN PRIVATE KEY-----` (or `RSA PRIVATE KEY`). | |
| intermediate_certificate | No | PEM-encoded intermediate CA chain. OPTIONAL for type=`custom` but recommended; without it some clients may fail trust validation. | |
| confirmation_token | No | Token from the prior plan response. Required on the apply phase only. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||