hostinger-api-mcp 1.60.1 → 1.61.0

package/types.d.ts

@@ -3770,16 +3770,112 @@ containing secrets (e.g. credential files) — none of these are returned by thi
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Returns the Git auto-deployment settings of the website: which repository and branch deploy
+into which directory, and whether pushes trigger a deployment. `is_enabled` false keeps the
+repository link but ignores pushes.
+
+When the website has no auto-deployment configured every field is null. Save settings with
+`Update Git auto-deployment settings`.
+   */
+  "hosting_getGitAutoDeploymentSettingsV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
+  /**
+   * Creates or replaces the Git auto-deployment settings of the website: repository, branch, the
+directory under the document root to deploy into, and `is_enabled`. Send the full set;
+`is_enabled` defaults to true and `directory` to the document root. `installation_uuid` must
+be an installation from `List Git installations` that belongs to the same customer as the
+website.
+
+For PHP and static websites, saving with `is_enabled` true deploys the branch right away and
+every later push to that branch deploys again. For Node.js and Website Builder websites saving
+does not clone anything. On a Node.js website start the first deploy with
+`Start Node.js build` using `source_type` `git`; pushes then trigger new builds with the build
+settings stored for the website.
+   */
+  "hosting_updateGitAutoDeploymentSettingsV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+      /**
+       * Active Git installation from `List Git installations`
+       */
+      installation_uuid: string;
+      /**
+       * Repository owner login, as returned by `List Git installation repositories`. GitLab group
+paths use slashes.
+       */
+      owner: string;
+      /**
+       * Repository name without the .git suffix
+       */
+      repository: string;
+      /**
+       * Branch to deploy
+       */
+      branch: string;
+      /**
+       * Subdirectory under the website document root to deploy into. Empty, null or omitted means
+the document root.
+       */
+      directory?: string;
+      /**
+       * Whether pushes to the branch deploy automatically
+       */
+      is_enabled?: boolean;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
+  /**
+   * Removes the Git auto-deployment settings of the website. Files already deployed stay on the
+website; pushes stop deploying until settings are saved again. Succeeds also when nothing is
+configured.
+   */
+  "hosting_deleteGitAutoDeploymentSettingsV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Lists the Git provider accounts the customer has connected. Only installations with status
 `active` are returned unless the `status` filter says otherwise.
 
 An empty list means the customer has no active installation. Check `status=suspended` and
-`status=pending` as well. If there is none at all, GitHub has to be connected once in hPanel
-(Websites, Manage, Advanced, Git, Connect GitHub; or Add Website, Node.js Web App, Import Git
-Repository, Continue with GitHub); this endpoint then lists the new installation.
+`status=pending` as well. If there is none at all, a Git provider (GitHub or GitLab) has to be
+connected once in hPanel (Websites, Manage, Advanced, Git; or Add Website, Node.js Web App,
+Import Git Repository); this endpoint then lists the new installation.
 
-Use `uuid` as the path parameter of `List Git installation repositories`.
+Use `uuid` as the path parameter of `List Git installation repositories`, and as
+`installation_uuid` in `Start Node.js build` with `source_type` `git` and in
+`Update Git auto-deployment settings`.
    */
   "hosting_listGitInstallationsV1": {
     params: {
@@ -3802,9 +3898,10 @@ is still queried and the call fails with whatever the provider answers. The list
 the first 500 repositories in the order the provider returns them; when the account has
 more, name the repository directly instead of searching this list.
 
-`owner`, `name` and `default_branch` identify a repository and a branch to deploy. Returns
-404 when the installation does not belong to the customer. Limited to 10 calls per minute
-per API client (429 above that).
+`owner`, `name` and a branch (`default_branch` or another one) go into `source_options` of
+`Start Node.js build` or into `Update Git auto-deployment settings`. Returns 404 when the
+installation does not belong to the customer. Limited to 10 calls per minute per API client
+(429 above that).
    */
   "hosting_listGitInstallationRepositoriesV1": {
     params: {
@@ -3855,13 +3952,17 @@ Use the `uuid` from a build to poll its output via the `Get Node.js Build Logs`
 WARNING: on success this overwrites the website's existing contents and cannot be
 undone — verify this is intended before calling this endpoint.
 
-The `source_type` must be `archive` and `source_options.archive_path` must point to an
-existing archive file on the server (relative to the website document root).
-Use the `Generate Upload URL` endpoint to obtain credentials and upload the archive first.
-
-To auto-detect build settings from an archive before starting, first call the
+With `source_type` `archive`, `source_options.archive_path` must point to an existing
+archive file on the server (relative to the website document root). Use the
+`Generate Upload URL` endpoint to obtain credentials and upload the archive first. To
+auto-detect build settings from an archive before starting, first call the
 `Get Node.js Build Settings from Archive` endpoint.
 
+With `source_type` `git`, `source_options` carries `owner`, `repository`, `branch` and
+`installation_uuid`. Take the installation from `List Git installations` and the owner and
+repository from `List Git installation repositories`; the branch is cloned at its current
+head. The installation must belong to the same customer as the website.
+
 The returned build `uuid` can be used to poll progress and retrieve logs via
 the `Get Node.js Build Logs` endpoint.
    */
@@ -3904,11 +4005,14 @@ the `Get Node.js Build Logs` endpoint.
        */
       package_manager?: string;
       /**
-       * The source type of the files
+       * Where the files come from: `archive` (an uploaded archive on the website) or `git`
+(a branch of a repository reachable through a Git installation).
        */
       source_type: string;
       /**
-       * Source-specific options
+       * Source-specific options. For `archive` send `archive_path`. For `git` send `owner`,
+`repository`, `branch` and `installation_uuid`, taken from `List Git installations`
+and `List Git installation repositories`.
        */
       source_options: object;
     };
@@ -4562,6 +4666,104 @@ Pass the `from` value exactly as returned by the list redirects endpoint.
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Requests a lifetime SSL certificate for the website. The installation runs in the background;
+`Get SSL status` reports `active` or `failed` when it ends. An `active` lifetime certificate
+does not block the request: a new installation is requested, which is how a certificate is
+reinstalled.
+
+Returns 422 for free subdomains (their certificate is managed by the platform), while an
+installation is `installing` or `waiting_for_retry`, when the website's certificate was
+revoked (it cannot be reissued), and when an uploaded custom certificate is installed; that
+one has to be uninstalled first.
+   */
+  "hosting_installSSLV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
+  /**
+   * Returns the SSL state of the website: the certificate `status` and `provider`, whether the
+certificate is a lifetime one managed by the platform, whether HTTP requests are redirected to
+HTTPS, when the certificate stops being valid and the last installation error.
+
+`installing` and `waiting_for_retry` mean an installation is in progress. `failed` means the
+last installation gave up, or the website was not updated for 60 minutes while `installing`;
+`last_error` holds the reason when it is a known message, otherwise it is null. `expired`
+means the assigned certificate's validity has ended. `not_installed` means no certificate is
+assigned. Free subdomains use a platform-managed certificate: with no installation recorded
+they report `active` with `provider` and `expires_at` null.
+   */
+  "hosting_getSSLStatusV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
+  /**
+   * Turns the HTTP to HTTPS redirect of the website on or off, based on `is_enabled`. Does
+nothing when the redirect is already in the requested state. Turning it on requires an
+installed certificate (`status` `active` or `expired` on `Get SSL status`) and returns 422
+when there is none; turning it off is always accepted.
+   */
+  "hosting_toggleHTTPSRedirectV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+      /**
+       * Turn the HTTP to HTTPS redirect on (true) or off (false) for the website.
+       */
+      is_enabled: boolean;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
+  /**
+   * Removes the SSL certificate assigned to the website, turns the HTTPS redirect off and cancels
+a pending installation retry. The website serves plain HTTP until a new installation
+completes. `Get SSL status` reports `not_installed` as soon as the call returns; the call also
+succeeds when no certificate is assigned, so repeating it is safe.
+
+Returns 422 for free subdomains (their certificate is managed by the platform) and while an
+installation is `installing`.
+   */
+  "hosting_uninstallSSLV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Retrieve a paginated list of websites (CloudLinux, Builder, and Horizons) accessible to the
 authenticated client.