List Combell accounts (instances of a servicepack such as a hosting package). Filter by asset type or by identifier (usually the domain name).

Get a Combell account by id, including its servicepack and addons.

Create a new account for a servicepack. SIDE EFFECT: this orders a product on your Combell reseller contract and may incur costs. Provisioning runs in the background: the result contains a provisioning job id to poll with combell_provisioning_jobs_get.

List the servicepacks (product packages) available on your Combell reseller contract, with their ids.

Get the status of a provisioning job (returned by account, MySQL database/user and domain operations). While the job is ongoing the response has status 'ongoing' with an estimated completion time; once finished it has status 'finished' and resource_links to the created resources. Do not retry the original operation until the job reports finished or cancelled; contact Combell support on 'failed'.

List the domain names on your Combell account with their expiration date and renewal state.

Get the details of a domain name: expiration, renewal state, name servers, registrant and whether renewal can be toggled.

Register an available domain name. SIDE EFFECT: this purchases a domain name and incurs costs. Registration runs in the background (202 Accepted); check the returned provisioning job. '.ca' domains are only available for registrants with country code 'CA'.

Transfer a domain name to Combell using its transfer authorization (EPP) code. SIDE EFFECT: this purchases a transfer and incurs costs. The transfer runs in the background (202 Accepted); check the returned provisioning job.

Replace the name servers of a domain name. SIDE EFFECT: DNS for the domain will resolve from the new name servers once propagated.

Enable or disable automatic renewal of a domain name. Only allowed when can_toggle_renew is true on the domain detail (no unpaid invoices and the renewal does not start within a month) and the API user has the finance role. SIDE EFFECT: disabling renewal lets the domain expire.

List the DNS records of a domain. Filter by type (A, AAAA, CAA, CNAME, MX, TXT, SRV, ALIAS, TLSA); record_name and service filters only apply together with a type filter.

Get a single DNS record of a domain by record id.

Create a DNS record on a domain. For A/AAAA/CNAME/MX/TXT/CAA/ALIAS/TLSA pass record_name + content (+ priority for MX); for SRV pass service, protocol, priority, weight, port and target. SIDE EFFECT: changes live DNS.

Update an existing DNS record. The current record is read first and only the fields you pass are changed, then the full record is written back. SRV service/protocol/port/target cannot be edited: delete and recreate instead. SIDE EFFECT: changes live DNS.

Delete a DNS record from a domain. SIDE EFFECT: irreversible and changes live DNS.

List the Linux hosting accounts (by domain name) on your Combell account.

Get the details of a Linux hosting: webspace size and usage, IP, FTP/SSH status and usernames, active PHP version, websites with host headers and SSL settings, and linked MySQL database names.

List the PHP versions available for a Linux hosting.

Change the PHP version of a Linux hosting. SIDE EFFECT: affects every website on the hosting immediately.

Set the PHP memory limit (in MB) of a Linux hosting.

Enable or disable PHP APCu caching on a Linux hosting and set its size (in MB).

Enable or disable GZIP compression on a Linux hosting.

Enable or disable FTP access on a Linux hosting.

Create a subsite (an extra website) on a Linux hosting. The folder path must already exist on the server; when omitted Combell uses /subsites/.

Delete a subsite from a Linux hosting. SIDE EFFECT: the website stops being served (files stay on disk).

Add a host header (an extra domain name or alias that serves the site) to a website on a Linux hosting.

Enable or disable HTTP/2 for a website on a Linux hosting. The site must have SSL enabled for HTTP/2 to work.

Enable or disable a free Let's Encrypt SSL certificate for a hostname on a Linux hosting.

Enable or disable the automatic HTTP to HTTPS redirect for a hostname on a Linux hosting.

List the scheduled tasks (cron jobs) of a Linux hosting.

Get a scheduled task of a Linux hosting by id.

Add a scheduled task (cron job) to a Linux hosting that runs a script on the hosting.

Update a scheduled task. The current task is read first and only the fields you pass are changed.

Delete a scheduled task from a Linux hosting. SIDE EFFECT: irreversible.

List every SSH public key on your Combell account, with the Linux hostings each key is attached to.

Enable or disable SSH access on a Linux hosting.

List the SSH public keys attached to a Linux hosting.

Attach an SSH public key to a Linux hosting so it can be used to log in over SSH/SFTP.

Remove an SSH public key (by fingerprint) from a Linux hosting. SIDE EFFECT: that key can no longer log in.

List the Windows hosting accounts (by domain name) on your Combell account.

Get the details of a Windows hosting: webspace size and usage, IP, FTP username, application pool (.NET runtimes), sites with bindings and MSSQL database names.

List the mailboxes of a domain with their maximum and used size (MB).

Get a mailbox: login, sizes, auto-reply and auto-forward settings.

Create a mailbox on a mail zone account. Find the account_id in the mail zone's available_accounts (combell_mail_zones_get).

Delete a mailbox and all its e-mail. SIDE EFFECT: irreversible.

Change the password of a mailbox.

Configure the auto-reply (out of office) of a mailbox.

Configure automatic forwarding of a mailbox to one or more addresses, optionally keeping a copy in the mailbox.

Get the mail zone of a domain: whether mail is enabled, the mail accounts (with the account_id needed to create mailboxes), aliases, anti-spam level, catch-all and extra SMTP domains.

Set a catch-all: e-mail sent to non-existent addresses on the domain is delivered to this address.

Remove a catch-all address from the mail zone.

Set the anti-spam level of the mail zone (none, basic or advanced). Check allowed_types on the mail zone first.

Create an e-mail alias that forwards to one or more destination addresses.

Replace the destination addresses of an existing alias. The change is processed in the background (202 Accepted).

Delete an e-mail alias. SIDE EFFECT: mail to the alias will bounce.

Add an extra SMTP domain to the mail zone, so mail sent to that domain is caught by the matching addresses on the main domain.

Enable or disable an extra SMTP domain on the mail zone. The change is processed in the background (202 Accepted).

Remove an extra SMTP domain from the mail zone.

List the MySQL databases on your Combell account with hostname, sizes, user count and account id.

Get a MySQL database by its (provisioned) name.

Create a MySQL database on an account (with a first read/write user). The name you pass is prefixed during provisioning, so the final database name differs. Runs in the background: poll the returned provisioning job for the resource link.

Delete a MySQL database and all its data. SIDE EFFECT: irreversible.

List the users of a MySQL database with their rights (read_and_write or read_only) and status.

Add a user to a MySQL database. New users get read_only rights. Runs in the background (202 Accepted).

Enable or disable a MySQL database user.

Change the password of a MySQL database user.

Delete a MySQL database user. Only users with read_only rights can be deleted. SIDE EFFECT: irreversible.

List the (paid) SSL certificates on your Combell account with common name, expiry, type and validation level. Let's Encrypt certificates are managed per hosting instead.

Get an SSL certificate by its SHA-1 fingerprint, including its subject alternative names.

List the pending SSL certificate requests (orders that are not issued yet).

Get an SSL certificate request. While ongoing it returns the domain validations to complete (DNS CNAME, file upload or e-mail) and a short-lived provider portal URL. When the certificate has been issued the result reports status 'completed' with the certificate location (HTTP 303); when the request no longer exists without a certificate it reports 'gone' (HTTP 410).

Order an SSL certificate from a certificate signing request (CSR). SIDE EFFECT: this purchases a paying product at your contract's (non-promotional) price. The CSR subject must contain CN, C, ST, L, O and E, and all SANs. After creation, complete the domain validations listed by combell_ssl_certificate_requests_get and then call combell_ssl_certificate_requests_verify.

Ask Combell to verify the domain validations of a certificate request once every non auto-validated value is in place. Calling it once is enough; verification takes some time. Reports 'completed' (303) or 'gone' (410) like the get tool.