hostinger-api-mcp 0.1.27 → 0.1.36

package/types.d.ts

@@ -162,7 +162,8 @@ export interface APITools {
   /**
    * Retrieve catalog items available for order.
 
-Prices in catalog items is displayed as cents (without floating point), e.g: float `17.99` is displayed as integer `1799`.
+Prices in catalog items is displayed as cents (without floating point),
+e.g: float `17.99` is displayed as integer `1799`.
 
 Use this endpoint to view available services and pricing before placing orders.
    */
@@ -180,42 +181,6 @@ Use this endpoint to view available services and pricing before placing orders.
     response: any; // Response structure will depend on the API
   };
 
-  /**
-   * Create a new service order. 
-
-**DEPRECATED**
-
-To purchase a domain, use [`POST /api/domains/v1/portfolio`](/#tag/domains-portfolio/POST/api/domains/v1/portfolio) instead.
-
-To purchase a VPS, use [`POST /api/vps/v1/virtual-machines`](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines) instead.
-
-
-To place order, you need to provide payment method ID and list of price items from the catalog endpoint together with quantity.
-Coupons also can be provided during order creation.
-
-Orders created using this endpoint will be set for automatic renewal.
-
-Some `credit_card` payments might need additional verification, rendering purchase unprocessed.
-We recommend use other payment methods than `credit_card` if you encounter this issue.
-   */
-  "billing_createServiceOrderV1": {
-    params: {
-      /**
-       * Payment method ID
-       */
-      payment_method_id: number;
-      /**
-       * items parameter
-       */
-      items: array;
-      /**
-       * Discount coupon codes
-       */
-      coupons?: array;
-    };
-    response: any; // Response structure will depend on the API
-  };
-
   /**
    * Set the default payment method for your account.
 
@@ -249,7 +214,8 @@ Use this endpoint to remove unused payment methods from user accounts.
   /**
    * Retrieve available payment methods that can be used for placing new orders.
 
-If you want to add new payment method, please use [hPanel](https://hpanel.hostinger.com/billing/payment-methods).
+If you want to add new payment method,
+please use [hPanel](https://hpanel.hostinger.com/billing/payment-methods).
 
 Use this endpoint to view available payment options before creating orders.
    */
@@ -385,7 +351,9 @@ Use this endpoint to modify domain DNS configuration.
        */
       domain: string;
       /**
-       * If `true`, resource records (RRs) matching name and type will be deleted and new RRs will be created, otherwise resource records' ttl's are updated and new records are appended. If no matching RRs are found, they are created.
+       * If `true`, resource records (RRs) matching name and type will be deleted and new RRs will be created,
+otherwise resource records' ttl's are updated and new records are appended.
+If no matching RRs are found, they are created.
        */
       overwrite?: boolean;
       /**
@@ -459,7 +427,9 @@ Use this endpoint to verify DNS record validity before applying changes.
        */
       domain: string;
       /**
-       * If `true`, resource records (RRs) matching name and type will be deleted and new RRs will be created, otherwise resource records' ttl's are updated and new records are appended. If no matching RRs are found, they are created.
+       * If `true`, resource records (RRs) matching name and type will be deleted and new RRs will be created,
+otherwise resource records' ttl's are updated and new records are appended.
+If no matching RRs are found, they are created.
        */
       overwrite?: boolean;
       /**
@@ -565,7 +535,8 @@ Use this endpoint to set up domain redirects to other URLs.
   /**
    * Enable domain lock for the domain.
 
-When domain lock is enabled, the domain cannot be transferred to another registrar without first disabling the lock.
+When domain lock is enabled,
+the domain cannot be transferred to another registrar without first disabling the lock.
 
 Use this endpoint to secure domains against unauthorized transfers.
    */
@@ -630,7 +601,7 @@ If registration fails, login to [hPanel](https://hpanel.hostinger.com/) and chec
 
 If no payment method is provided, your default payment method will be used automatically.
 
-If no WHOIS information is provided, default contact information for that TLD will be used. 
+If no WHOIS information is provided, default contact information for that TLD will be used.
 Before making request, ensure WHOIS information for desired TLD exists in your account.
 
 Some TLDs require `additional_details` to be provided and these will be validated before completing purchase.
@@ -826,8 +797,10 @@ Use this endpoint to view which domains use specific contact profiles.
   };
 
   /**
-   * Retrieve a list of datacenters available for setting up hosting plans based on available datacenter capacity and hosting plan of your order.
-The first item in the list is the best match for your specific order requirements.
+   * Retrieve a list of datacenters available for setting up hosting plans
+based on available datacenter capacity and hosting plan of your order.
+The first item in the list is the best match for your specific order
+requirements.
    */
   "hosting_listAvailableDatacentersV1": {
     params: {
@@ -841,7 +814,8 @@ The first item in the list is the best match for your specific order requirement
 
   /**
    * Generate a unique free subdomain that can be used for hosting services without purchasing custom domains.
-Free subdomains allow you to start using hosting services immediately and you can always connect a custom domain to your site later.
+Free subdomains allow you to start using hosting services immediately
+and you can always connect a custom domain to your site later.
    */
   "hosting_generateAFreeSubdomainV1": {
     params: {
@@ -873,9 +847,11 @@ Skip this verification when using Hostinger's free subdomains (*.hostingersite.c
   /**
    * Retrieve a paginated list of orders accessible to the authenticated client.
 
-This endpoint returns orders of your hosting accounts as well as orders of other client hosting accounts that have shared access with you.
+This endpoint returns orders of your hosting accounts as well as orders
+of other client hosting accounts that have shared access with you.
 
-Use the available query parameters to filter results by order statuses or specific order IDs for more targeted results.
+Use the available query parameters to filter results by order statuses
+or specific order IDs for more targeted results.
    */
   "hosting_listOrdersV1": {
     params: {
@@ -902,9 +878,12 @@ Use the available query parameters to filter results by order statuses or specif
   /**
    * Retrieve a paginated list of websites (main and addon types) accessible to the authenticated client.
 
-This endpoint returns websites from your hosting accounts as well as websites from other client hosting accounts that have shared access with you.
+This endpoint returns websites from your hosting accounts as well as
+websites from other client hosting accounts that have shared access
+with you.
 
-Use the available query parameters to filter results by username, order ID, enabled status, or domain name for more targeted results.
+Use the available query parameters to filter results by username,
+order ID, enabled status, or domain name for more targeted results.
    */
   "hosting_listWebsitesV1": {
     params: {
@@ -939,11 +918,15 @@ Use the available query parameters to filter results by username, order ID, enab
   /**
    * Create a new website for the authenticated client.
 
-Provide the domain name and associated order ID to create a new website. The datacenter_code parameter is required when creating the first website on a new hosting plan - this will set up and configure new hosting account in the selected datacenter.
+Provide the domain name and associated order ID to create a new website.
+The datacenter_code parameter is required when creating the first website
+on a new hosting plan - this will set up and configure new hosting account
+in the selected datacenter.
 
 Subsequent websites will be hosted on the same datacenter automatically.
 
-Website creation takes up to a few minutes to complete. Check the websites list endpoint to see when your new website becomes available.
+Website creation takes up to a few minutes to complete. Check the
+websites list endpoint to see when your new website becomes available.
    */
   "hosting_createWebsiteV1": {
     params: {
@@ -1019,7 +1002,8 @@ You can filter contacts by group UUID and subscription status.
 
 This endpoint allows you to create a new contact with basic information like name, email, and surname.
 
-If double opt-in is enabled, the contact will be created with a pending status and a confirmation email will be sent.
+If double opt-in is enabled,
+the contact will be created with a pending status and a confirmation email will be sent.
    */
   "reach_createANewContactV1": {
     params: {
@@ -1119,6 +1103,40 @@ Segments are used to organize and group contacts based on specific criteria.
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Create a new contact in the email marketing system.
+
+This endpoint allows you to create a new contact with basic information like name, email, and surname.
+
+If double opt-in is enabled, the contact will be created with a pending status
+and a confirmation email will be sent.
+   */
+  "reach_createNewContactsV1": {
+    params: {
+      /**
+       * Profile uuid parameter
+       */
+      profileUuid: string;
+      /**
+       * email parameter
+       */
+      email: string;
+      /**
+       * name parameter
+       */
+      name?: string;
+      /**
+       * surname parameter
+       */
+      surname?: string;
+      /**
+       * note parameter
+       */
+      note?: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * This endpoint returns all profiles available to the client, including their basic information.
    */
@@ -1144,7 +1162,8 @@ Use this endpoint to view location options before deploying VPS instances.
   /**
    * Retrieves a list of all containers belonging to a specific Docker Compose project on the virtual machine. 
 
-This endpoint returns detailed information about each container including their current status, port mappings, and runtime configuration. 
+This endpoint returns detailed information about each container including
+their current status, port mappings, and runtime configuration.
 
 Use this to monitor the health and state of all services within your Docker Compose project.
    */
@@ -1163,7 +1182,8 @@ Use this to monitor the health and state of all services within your Docker Comp
   };
 
   /**
-   * Retrieves the complete project information including the docker-compose.yml file contents, project metadata, and current deployment status. 
+   * Retrieves the complete project information including the docker-compose.yml
+file contents, project metadata, and current deployment status.
 
 This endpoint provides the full configuration and state details of a specific Docker Compose project. 
 
@@ -1208,9 +1228,11 @@ Use this when you want to permanently remove a project and free up system resour
   /**
    * Retrieves a list of all Docker Compose projects currently deployed on the virtual machine. 
 
-This endpoint returns basic information about each project including name, status, file path and list of containers with 
-details about their names, image, status, health and ports. Container stats are omitted in this endpoint.
-If you need to get detailed information about container with stats included, use the `Get project containers` endpoint. 
+This endpoint returns basic information about each project including name,
+status, file path and list of containers with details about their names,
+image, status, health and ports. Container stats are omitted in this
+endpoint. If you need to get detailed information about container with
+stats included, use the `Get project containers` endpoint.
 
 Use this to get an overview of all Docker projects on your VPS instance.
    */
@@ -1227,8 +1249,10 @@ Use this to get an overview of all Docker projects on your VPS instance.
   /**
    * Deploy new project from docker-compose.yaml contents or download contents from URL. 
 
-URL can be Github repository url in format https://github.com/[user]/[repo] and it will be automatically resolved to 
-docker-compose.yaml file in master branch. Any other URL provided must return docker-compose.yaml file contents.
+URL can be Github repository url in format https://github.com/[user]/[repo]
+and it will be automatically resolved to docker-compose.yaml file in
+master branch. Any other URL provided must return docker-compose.yaml
+file contents.
 
 If project with the same name already exists, existing project will be replaced.
    */
@@ -1260,7 +1284,8 @@ If project with the same name already exists, existing project will be replaced.
 This endpoint returns recent log output from each container, organized by service name with timestamps. 
 The response contains the last 300 log entries across all services. 
 
-Use this for debugging, monitoring application behavior, and troubleshooting issues across your entire project stack.
+Use this for debugging, monitoring application behavior, and
+troubleshooting issues across your entire project stack.
    */
   "VPS_getProjectLogsV1": {
     params: {
@@ -1277,7 +1302,8 @@ Use this for debugging, monitoring application behavior, and troubleshooting iss
   };
 
   /**
-   * Restarts all services in a Docker Compose project by stopping and starting containers in the correct dependency order. 
+   * Restarts all services in a Docker Compose project by stopping and starting
+containers in the correct dependency order.
 
 This operation preserves data volumes and network configurations while refreshing the running containers. 
 
@@ -1319,7 +1345,8 @@ Use this to resume a project that was previously stopped or to start services af
   };
 
   /**
-   * Stops all running services in a Docker Compose project while preserving container configurations and data volumes. 
+   * Stops all running services in a Docker Compose project while preserving
+container configurations and data volumes.
 
 This operation gracefully shuts down containers in reverse dependency order. 
 
@@ -1340,11 +1367,13 @@ Use this to temporarily halt a project without removing data or configurations.
   };
 
   /**
-   * Updates a Docker Compose project by pulling the latest image versions and recreating containers with new configurations. 
+   * Updates a Docker Compose project by pulling the latest image versions and
+recreating containers with new configurations.
 
 This operation preserves data volumes while applying changes from the compose file. 
 
-Use this to deploy application updates, apply configuration changes, or refresh container images to their latest versions.
+Use this to deploy application updates, apply configuration changes, or
+refresh container images to their latest versions.
    */
   "VPS_updateProjectV1": {
     params: {
@@ -1465,7 +1494,8 @@ Use this endpoint to set up new firewall configurations for VPS security.
   /**
    * Update a specific firewall rule from a specified firewall.
 
-Any virtual machine that has this firewall activated will lose sync with the firewall and will have to be synced again manually.
+Any virtual machine that has this firewall activated will lose sync with the firewall
+and will have to be synced again manually.
 
 Use this endpoint to modify existing firewall rules.
    */
@@ -1502,8 +1532,9 @@ Use this endpoint to modify existing firewall rules.
   /**
    * Delete a specific firewall rule from a specified firewall.
 
-Any virtual machine that has this firewall activated will lose sync with the firewall and will have to be synced again manually.
-       
+Any virtual machine that has this firewall activated will lose sync with the firewall
+and will have to be synced again manually.
+
 Use this endpoint to remove specific firewall rules.
    */
   "VPS_deleteFirewallRuleV1": {
@@ -1523,9 +1554,11 @@ Use this endpoint to remove specific firewall rules.
   /**
    * Create new firewall rule for a specified firewall.
 
-By default, the firewall drops all incoming traffic, which means you must add accept rules for all ports you want to use.
+By default, the firewall drops all incoming traffic,
+which means you must add accept rules for all ports you want to use.
 
-Any virtual machine that has this firewall activated will lose sync with the firewall and will have to be synced again manually.
+Any virtual machine that has this firewall activated will lose sync with the firewall
+and will have to be synced again manually.
 
 Use this endpoint to add new security rules to firewalls.
    */
@@ -1647,7 +1680,8 @@ Use this endpoint to view available automation scripts for VPS deployment.
   /**
    * Add a new post-install script to your account, which can then be used after virtual machine installation.
 
-The script contents will be saved to the file `/post_install` with executable attribute set and will be executed once virtual machine is installed.
+The script contents will be saved to the file `/post_install` with executable attribute set
+and will be executed once virtual machine is installed.
 The output of the script will be redirected to `/post_install.log`. Maximum script size is 48KB.
 
 Use this endpoint to create automation scripts for VPS setup tasks.
@@ -1787,9 +1821,10 @@ Use this endpoint to monitor specific VPS operation status and details.
   /**
    * Retrieve actions performed on a specified virtual machine.
 
-Actions are operations or events that have been executed on the virtual machine, such as starting, stopping, or modifying 
-the machine. This endpoint allows you to view the history of these actions, providing details about each action, 
-such as the action name, timestamp, and status.
+Actions are operations or events that have been executed on the virtual
+machine, such as starting, stopping, or modifying the machine. This endpoint
+allows you to view the history of these actions, providing details about
+each action, such as the action name, timestamp, and status.
 
 Use this endpoint to view VPS operation history and troubleshoot issues.
    */
@@ -1936,7 +1971,8 @@ Use this endpoint to view available VPS instances.
   /**
    * Purchase and setup a new virtual machine.
 
-If virtual machine setup fails for any reason, login to [hPanel](https://hpanel.hostinger.com/) and complete the setup manually.
+If virtual machine setup fails for any reason, login to
+[hPanel](https://hpanel.hostinger.com/) and complete the setup manually.
 
 If no payment method is provided, your default payment method will be used automatically.
 
@@ -1965,10 +2001,12 @@ Use this endpoint to create new VPS instances.
   };
 
   /**
-   * Retrieve scan metrics for the [Monarx](https://www.monarx.com/) malware scanner installed on a specified virtual machine.
+   * Retrieve scan metrics for the [Monarx](https://www.monarx.com/) malware scanner
+installed on a specified virtual machine.
 
-The scan metrics provide detailed information about malware scans performed by Monarx, including number of scans, 
-detected threats, and other relevant statistics. This information is useful for monitoring security status of the 
+The scan metrics provide detailed information about malware scans performed
+by Monarx, including number of scans, detected threats, and other relevant
+statistics. This information is useful for monitoring security status of the
 virtual machine and assessing effectiveness of the malware scanner.
 
 Use this endpoint to monitor VPS security scan results and threat detection.
@@ -1986,8 +2024,10 @@ Use this endpoint to monitor VPS security scan results and threat detection.
   /**
    * Install the Monarx malware scanner on a specified virtual machine.
 
-[Monarx](https://www.monarx.com/) is a security tool designed to detect and prevent malware infections on virtual machines. 
-By installing Monarx, users can enhance the security of their virtual machines, ensuring that they are protected against malicious software.
+[Monarx](https://www.monarx.com/) is a security tool designed to detect and
+prevent malware infections on virtual machines. By installing Monarx, users
+can enhance the security of their virtual machines, ensuring that they are
+protected against malicious software.
 
 Use this endpoint to enable malware protection on VPS instances.
    */
@@ -2051,7 +2091,8 @@ Use this endpoint to monitor VPS performance and resource utilization over time.
   /**
    * Set nameservers for a specified virtual machine.
 
-Be aware, that improper nameserver configuration can lead to the virtual machine being unable to resolve domain names.
+Be aware, that improper nameserver configuration can lead to the virtual
+machine being unable to resolve domain names.
 
 Use this endpoint to configure custom DNS resolvers for VPS instances.
    */
@@ -2103,7 +2144,8 @@ Use this endpoint to configure reverse DNS lookup for VPS IP addresses.
   /**
    * Delete a PTR (Pointer) record for a specified virtual machine.
 
-Once deleted, reverse DNS lookups to the virtual machine's IP address will no longer return the previously configured hostname.
+Once deleted, reverse DNS lookups to the virtual machine's IP address will
+no longer return the previously configured hostname.
 
 Use this endpoint to remove reverse DNS configuration from VPS instances.
    */
@@ -2125,7 +2167,8 @@ Use this endpoint to remove reverse DNS configuration from VPS instances.
    * Set panel password for a specified virtual machine.
 
 If virtual machine does not use panel OS, the request will still be processed without any effect.
-Requirements for password are same as in the [recreate virtual machine endpoint](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines/{virtualMachineId}/recreate).
+Requirements for password are same as in the [recreate virtual machine
+endpoint](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines/{virtualMachineId}/recreate).
 
 Use this endpoint to configure control panel access credentials for VPS instances.
    */
@@ -2188,7 +2231,8 @@ Use this endpoint to exit system rescue mode and return VPS to normal operation.
   /**
    * Recreate a virtual machine from scratch.
 
-The recreation process involves reinstalling the operating system and resetting the virtual machine to its initial state.
+The recreation process involves reinstalling the operating system and
+resetting the virtual machine to its initial state.
 Snapshots, if there are any, will be deleted.
 
 ## Password Requirements
@@ -2215,11 +2259,14 @@ Use this endpoint to completely rebuild VPS instances with fresh OS installation
        */
       template_id: number;
       /**
-       * Root password for the virtual machine. If not provided, random password will be generated. Password will not be shown in the response.
+       * Root password for the virtual machine. If not provided, random password will be generated.
+Password will not be shown in the response.
        */
       password?: string;
       /**
-       * Panel password for the panel-based OS template. If not provided, random password will be generated. If OS does not support panel_password this field will be ignored. Password will not be shown in the response.
+       * Panel password for the panel-based OS template. If not provided, random password will be generated.
+If OS does not support panel_password this field will be ignored.
+Password will not be shown in the response.
        */
       panel_password?: string;
       /**
@@ -2250,7 +2297,8 @@ Use this endpoint to reboot VPS instances.
   /**
    * Set root password for a specified virtual machine.
 
-Requirements for password are same as in the [recreate virtual machine endpoint](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines/{virtualMachineId}/recreate).
+Requirements for password are same as in the [recreate virtual machine
+endpoint](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines/{virtualMachineId}/recreate).
 
 Use this endpoint to update administrator credentials for VPS instances.
    */
@@ -2292,7 +2340,8 @@ Use this endpoint to configure and initialize purchased VPS instances.
        */
       post_install_script_id?: number;
       /**
-       * Password for the virtual machine. If not provided, random password will be generated. Password will not be shown in the response.
+       * Password for the virtual machine. If not provided, random password will be generated.
+Password will not be shown in the response.
        */
       password?: string;
       /**
@@ -2378,7 +2427,8 @@ Use this endpoint to remove VPS snapshots.
   /**
    * Restore a specified virtual machine to a previous state using a snapshot.
 
-Restoring from a snapshot allows users to revert the virtual machine to that state, which is useful for system recovery, undoing changes, or testing.
+Restoring from a snapshot allows users to revert the virtual machine to that state,
+which is useful for system recovery, undoing changes, or testing.
 
 Use this endpoint to revert VPS instances to previous saved states.
    */