hostinger-api-mcp 1.43.1 → 1.45.0

package/types.d.ts

@@ -306,6 +306,55 @@ If this is the only domain on the website, unlinking leaves the website without
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Generate a file browser upload URL with authentication credentials for uploading files
+to an Agency Plan website's file storage.
+
+Returns `url`, `auth_key` and `rest_auth_key`. Use these to upload a file to the
+website's file storage via the TUS resumable upload protocol (TUS 1.0.0). Send
+`X-Auth: {auth_key}` and `X-Auth-Rest: {rest_auth_key}` headers on every request below.
+
+1. Create the upload: `POST` to `{url}/{relative_file_path}?override=true` with headers
+   `upload-length: {file size in bytes}` and `upload-offset: 0`. Expect `201 Created`.
+2. Upload the file: send the file bytes to the same location (any TUS 1.0.0 client, or
+   `PATCH` requests with an `upload-offset` header tracking progress) until complete.
+
+`relative_file_path` is the destination path inside the website's file storage, e.g.
+`app.zip`.
+
+Instead of a TUS client, plain `curl` also works:
+```
+FILE=app.zip
+SIZE=$(stat -f%z "$FILE")   # stat -c%s on Linux
+
+curl -i -X POST "{url}/${FILE}?override=true" \
+  -H "X-Auth: {auth_key}" \
+  -H "X-Auth-Rest: {rest_auth_key}" \
+  -H "Tus-Resumable: 1.0.0" \
+  -H "Upload-Length: ${SIZE}" \
+  -H "Upload-Offset: 0"
+# -> 201 Created
+
+curl -i -X PATCH "{url}/${FILE}?override=true" \
+  -H "X-Auth: {auth_key}" \
+  -H "X-Auth-Rest: {rest_auth_key}" \
+  -H "Tus-Resumable: 1.0.0" \
+  -H "Content-Type: application/offset+octet-stream" \
+  -H "Upload-Offset: 0" \
+  --data-binary "@${FILE}"
+# -> 204 No Content, Upload-Offset response header equals SIZE when done
+```
+   */
+  "agency-hosting_generateUploadURLV1": {
+    params: {
+      /**
+       * Agency Plan website UID
+       */
+      website_uid: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Imports an Agency Plan website from an already-uploaded archive.
 
@@ -823,6 +872,51 @@ resources are removed in the background.
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Retrieve a paginated list of Agency Plan websites (H5G, Builder, and Horizons) 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.
+
+The response shape differs per platform — see the `platform` field on each item.
+
+Use `website_types` to list only websites of a given detected type, e.g. only
+WordPress websites (`website_types=wordpress`) or only Node.js websites
+(`website_types=nodejs`). Combine with `order_ids`, `states`, or `domain` for more
+targeted results.
+   */
+  "agency-hosting_listAgencyPlanWebsitesV1": {
+    params: {
+      /**
+       * Page number
+       */
+      page?: number;
+      /**
+       * Number of items per page
+       */
+      per_page?: number;
+      /**
+       * Filter by order IDs. Accepts a comma-separated list.
+       */
+      order_ids?: array;
+      /**
+       * Filter by website state. Accepts a comma-separated list.
+       */
+      states?: array;
+      /**
+       * Filter by detected website type, e.g. wordpress,nodejs. Accepts a comma-separated list.
+       */
+      website_types?: array;
+      /**
+       * Filter by domain name (case-insensitive substring match)
+       */
+      domain?: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Lists active and recently completed asynchronous processes for an Agency Plan website.
 
@@ -2611,7 +2705,7 @@ Use the domain and is_assigned filters to find databases assigned to a specific
        */
       per_page?: number;
       /**
-       * Filter by domain name (exact match)
+       * Filter by domain name (case-insensitive substring match)
        */
       domain?: string;
       /**
@@ -2977,6 +3071,59 @@ Skip this verification when using Hostinger's free subdomains (*.hostingersite.c
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Generate a file browser upload URL with authentication credentials
+for uploading files directly to a website's file storage.
+
+Returns `url`, `auth_key` and `rest_auth_key`. Use these to upload a file to the
+website's `public_html` directory via the TUS resumable upload protocol (TUS 1.0.0).
+Send `X-Auth: {auth_key}` and `X-Auth-Rest: {rest_auth_key}` headers on every request
+below.
+
+1. Create the upload: `POST` to `{url}/{relative_file_path}?override=true` with headers
+   `upload-length: {file size in bytes}` and `upload-offset: 0`. Expect `201 Created`.
+2. Upload the file: send the file bytes to the same location (any TUS 1.0.0 client, or
+   `PATCH` requests with an `upload-offset` header tracking progress) until complete.
+
+`relative_file_path` is the destination path inside `public_html`, e.g. `app.zip`.
+
+Instead of a TUS client, plain `curl` also works:
+```
+FILE=app.zip
+SIZE=$(stat -f%z "$FILE")   # stat -c%s on Linux
+
+curl -i -X POST "{url}/${FILE}?override=true" \
+  -H "X-Auth: {auth_key}" \
+  -H "X-Auth-Rest: {rest_auth_key}" \
+  -H "Tus-Resumable: 1.0.0" \
+  -H "Upload-Length: ${SIZE}" \
+  -H "Upload-Offset: 0"
+# -> 201 Created
+
+curl -i -X PATCH "{url}/${FILE}?override=true" \
+  -H "X-Auth: {auth_key}" \
+  -H "X-Auth-Rest: {rest_auth_key}" \
+  -H "Tus-Resumable: 1.0.0" \
+  -H "Content-Type: application/offset+octet-stream" \
+  -H "Upload-Offset: 0" \
+  --data-binary "@${FILE}"
+# -> 204 No Content, Upload-Offset response header equals SIZE when done
+```
+   */
+  "hosting_generateUploadURLV1": {
+    params: {
+      /**
+       * Account username
+       */
+      username: string;
+      /**
+       * Website domain
+       */
+      domain: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * List files and directories under a website's document root.
 
@@ -3082,9 +3229,79 @@ Use the `uuid` from a build to poll its output via the `Get Node.js Build Logs`
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Start a Node.js build process using files already present on the website's file storage.
+
+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
+`Get Node.js Build Settings from Archive` endpoint. To upload an archive and start
+a build in one step, use the `Create Node.js Build from Archive` endpoint instead.
+
+The returned build `uuid` can be used to poll progress and retrieve logs via
+the `Get Node.js Build Logs` endpoint.
+   */
+  "hosting_startNode_jsBuildV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+      /**
+       * Node.js version
+       */
+      node_version: number;
+      /**
+       * Node.js application type
+       */
+      app_type: string;
+      /**
+       * Application root directory (where package.json is located) relative to public_html
+       */
+      root_directory: string;
+      /**
+       * Build output directory relative to the root directory
+       */
+      output_directory: string;
+      /**
+       * Build script that will be ran to build the application
+       */
+      build_script: string;
+      /**
+       * The main entry point file for the application
+       */
+      entry_file?: string;
+      /**
+       * Package manager
+       */
+      package_manager?: string;
+      /**
+       * The source type of the files
+       */
+      source_type: string;
+      /**
+       * Source-specific options
+       */
+      source_options: object;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Upload a project archive, auto-detect build settings, and immediately start a Node.js build.
 
+WARNING: on success this overwrites the website's existing contents and cannot be
+undone — verify this is intended before calling this endpoint.
+
 This is the recommended single-step approach for deploying a Node.js application.
 The archive is uploaded to the website's file storage, build settings are auto-detected
 from the package.json inside the archive, and the build process starts automatically.
@@ -3150,6 +3367,36 @@ the `Get Node.js Build Logs` endpoint.
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Auto-detect Node.js build settings from a package.json inside an archive already on the server.
+
+Use this before calling `Start Node.js Build` to preview what settings will be used,
+or to let the user review and override values (framework, node version, root directory,
+output directory, build script) before committing to a build.
+
+The archive must already be present on the website's file storage. Use the
+`Generate Upload URL` endpoint to obtain credentials and upload the archive first.
+To upload an archive and start a build in one step without inspecting settings first,
+use the `Create Node.js Build from Archive` endpoint instead.
+   */
+  "hosting_getNode_jsBuildSettingsFromArchiveV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+      /**
+       * The path to the archive file relative to the document root of the vhost
+       */
+      archive_path: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Retrieve logs from a specific Node.js build process.
 
@@ -3526,8 +3773,11 @@ website detected on the underlying platform (`wordpress`, `builder`,
 `vhost_type`, `username`, and `root_directory`, only apply to
 CloudLinux websites and are null for other platforms.
 
-Use the available query parameters to filter results by username,
-order ID, enabled status, or domain name for more targeted results.
+Use `website_types` to list only websites of a given detected type, e.g. only
+WordPress websites (`website_types=wordpress`) or only Node.js websites
+(`website_types=nodejs`). Combine with the other available query parameters to
+filter by username, order ID, enabled status, or domain name for more targeted
+results.
    */
   "hosting_listWebsitesV1": {
     params: {
@@ -3552,9 +3802,13 @@ order ID, enabled status, or domain name for more targeted results.
        */
       is_enabled?: boolean;
       /**
-       * Filter by domain name (exact match)
+       * Filter by domain name (case-insensitive substring match)
        */
       domain?: string;
+      /**
+       * Filter by detected website type, e.g. wordpress,nodejs. Accepts a comma-separated list.
+       */
+      website_types?: array;
     };
     response: any; // Response structure will depend on the API
   };
@@ -3590,6 +3844,38 @@ websites list endpoint to see when your new website becomes available.
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Deploy a static application from an archive file.
+
+WARNING: this overwrites the website's existing contents and cannot be undone —
+verify this is intended before calling this endpoint.
+
+This endpoint allows you to deploy a static application from an archive
+file that has been uploaded to the website's directory.
+
+This only works for static sites (pre-built HTML/CSS/JS with no build step). For
+Node.js applications, use `Create NodeJS build from archive` instead, or
+`Start Node.js build` if the archive is already uploaded. For WordPress sites,
+use `Import WordPress website`.
+   */
+  "hosting_deployStaticSiteArchiveV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+      /**
+       * Relative path to the archive file from website root directory
+       */
+      archive_path: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * This endpoint permanently removes a website and all of its data. This action
 cannot be undone. Before calling it, make sure the user understands the
@@ -7129,6 +7415,37 @@ detected installations once the scan completes.
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Import WordPress website to the specified domain.
+
+WARNING: this overwrites the website's existing contents and cannot be undone —
+verify this is intended before calling this endpoint.
+
+This endpoint allows you to import a WordPress website from archive and
+database files that have been uploaded to the website's directory.
+   */
+  "hosting_importWordPressWebsiteV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+      /**
+       * Path to the WordPress archive file (relative to website root)
+       */
+      archive_path: string;
+      /**
+       * Path to the database SQL file (relative to website root)
+       */
+      sql_path: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Install WordPress on an existing website.
 
@@ -7211,7 +7528,7 @@ Each installation includes a `valid` flag and, when invalid, a
        */
       username?: string;
       /**
-       * Filter by domain name (exact match)
+       * Filter by domain name (case-insensitive substring match)
        */
       domain?: string;
       /**
@@ -7521,6 +7838,34 @@ deactivation job has been queued.
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Deploy a WordPress plugin from an already uploaded directory.
+
+This endpoint allows you to deploy a WordPress plugin that has been uploaded to the website's directory.
+The plugin will be activated and made available in the WordPress admin panel.
+   */
+  "hosting_deployWordPressPluginV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+      /**
+       * Slug of the plugin
+       */
+      slug: string;
+      /**
+       * Relative path to the plugin directory from wp-content/plugins
+       */
+      plugin_path: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Install one or more plugins on an existing WordPress installation.
 
@@ -7635,7 +7980,7 @@ domain. Optionally filter by domain to scope the check.
   "hosting_checkIfWooCommerceIsInstalledV1": {
     params: {
       /**
-       * Filter by domain name (exact match)
+       * Filter by domain name (case-insensitive substring match)
        */
       domain?: string;
     };
@@ -7751,6 +8096,38 @@ job has been queued.
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Deploy a WordPress theme from an already uploaded directory.
+
+This endpoint allows you to deploy a WordPress theme that has been uploaded to the website's directory.
+The theme can be optionally activated after deployment.
+   */
+  "hosting_deployWordPressThemeV1": {
+    params: {
+      /**
+       * username parameter
+       */
+      username: string;
+      /**
+       * Domain name
+       */
+      domain: string;
+      /**
+       * Slug of the theme
+       */
+      slug: string;
+      /**
+       * Relative path to the theme directory from wp-content/themes
+       */
+      theme_path: string;
+      /**
+       * Whether to activate the theme after deployment
+       */
+      is_activated?: boolean;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Install a theme on an existing WordPress installation.