Skip to main content
Version: v0.22.x

Authentication & API access

H2O Cascade exposes a REST API for interacting with the platform programmatically. There is currently no separate Python SDK — all interactions are done via standard HTTP requests. You can perform all actions available in the UI (like uploading datasets, running experiments, or deploying models) directly via API.

Generate Your API Key​

To authenticate with the API, you’ll need to generate a personal API key:

  1. Log in to your environment

    Log in to your H2O Cascade environment.

  2. Open the API Keys page

    Click on your name in the top-right corner, then select API Keys.

  3. Generate a new key

    If no key has been generated yet, click Generate New API Key.

  4. Copy the key immediately

    You’ll be shown the key only once — make sure to copy it to a safe location immediately.

    Note

    Lost it? Just generate a new one — this will invalidate any existing key.

  5. Confirm the key is listed

    After generation, you’ll see your key listed (e.g. <your name>'s API Key) with usage status and timestamp.

Accessing the REST API Docs​

To explore and try the API directly in your browser:

  1. Click on your name in the top-right again and select API Docs.
  2. The API reference is specific to your environment — it is not publicly accessible.
  3. Click Authorize and paste your API key to authenticate your session.

Once authenticated, you can use the interface to:

  • List your projects
  • Upload or retrieve datasets
  • Start or stop experiments
  • Create or update deployments

Everything in the platform is accessible via API — it's fully scriptable.

Feedback

Related content

H2O Cascade API Quickstart Guide
Experiments