> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Weights & Biases with API Key – StackOne Hub

> Link a Weights & Biases account in the StackOne Hub using API Key. End-user guide to authorize the integration and start using Weights & Biases actions.

<section data-guide-section data-guide-scopes="">
  <h2>Generate a Weights & Biases API key</h2>

  <p>A Weights & Biases API key authenticates requests against the W\&B GraphQL Public API on behalf of your account. The key inherits the full permissions of the user who mints it — W\&B keys have no scopes, permission picker, or expiration.</p>

  <Steps>
    <Step title="Sign in to Weights & Biases">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Go to the <a href="https://wandb.ai/login" target="_blank" rel="noopener noreferrer">W\&B sign-in page</a> and complete <strong>Log In</strong>. You can sign in with <strong>Sign in with Apple</strong>, <strong>Sign in with GitHub</strong>, <strong>Sign in with Google</strong>, <strong>Sign in with Microsoft</strong>, or with your email and password using the <strong>Email</strong> and <strong>Password</strong> fields.</p>

        <ul>
          <li>Don't have an account? Use the <strong>Sign up</strong> tab on the same screen, or open <a href="https://app.wandb.ai/login?signup=true" target="_blank" rel="noopener noreferrer">app.wandb.ai/login?signup=true</a>.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/qvjvrTQfFPbTg9IV/connectors/weightsandbiases/images/custom-config-sign-in.png?fit=max&auto=format&n=qvjvrTQfFPbTg9IV&q=85&s=a642fb0841afa05e8dc87a0af5da477a" alt="Weights & Biases sign-in dialog showing SSO options and the email/password form." width="1280" height="800" data-path="connectors/weightsandbiases/images/custom-config-sign-in.png" />
      </div>
    </Step>

    <Step title="Open API keys from the avatar menu">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Once signed in, click your profile avatar in the top-right corner to open the <strong>Toggle profile & account menu</strong>, then click <strong>API keys</strong> in the <strong>Account</strong> section of the dropdown. This lands you on the <strong>API keys</strong> panel of <strong>User settings</strong> (`https://wandb.ai/settings#apikeys`) where every key on your account is listed.</p>

        <img src="https://mintcdn.com/stackone-60/qvjvrTQfFPbTg9IV/connectors/weightsandbiases/images/custom-config-avatar-menu.png?fit=max&auto=format&n=qvjvrTQfFPbTg9IV&q=85&s=5e2a0c5b55bfb1a57a005a5e322d8ebb" alt="Weights & Biases avatar dropdown with the API keys entry under the Account section highlighted." width="1280" height="800" data-path="connectors/weightsandbiases/images/custom-config-avatar-menu.png" />
      </div>
    </Step>

    <Step title="Create a new API key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the <strong>API keys</strong> panel click <strong>+ New key</strong> to open the <strong>Create new API key</strong> dialog. On <strong>Step 1 of 2 : Configure key</strong>, optionally enter a value in the <strong>Name (optional)</strong> field (the default is <strong>Untitled Key</strong>), then click <strong>Create API key</strong> to advance to Step 2.</p>

        <ul>
          <li>Choose a descriptive name — the name appears in the <strong>API keys</strong> list so you can identify which key is used by StackOne when it's time to rotate or revoke it.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/qvjvrTQfFPbTg9IV/connectors/weightsandbiases/images/custom-config-new-key-dialog.png?fit=max&auto=format&n=qvjvrTQfFPbTg9IV&q=85&s=040fa2a5fd9f696f4521d5bd896f34f7" alt="Create new API key dialog on Step 1 of 2 Configure key with the Name field and Create API key button." width="1280" height="800" data-path="connectors/weightsandbiases/images/custom-config-new-key-dialog.png" />
      </div>
    </Step>

    <Step title="Copy the new key from the Your new API key dialog">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On Step 2 the <strong>Your new API key</strong> dialog appears with the freshly minted key. Click <strong>Copy</strong> next to the <strong>API KEY</strong> value to copy the key to your clipboard, or click <strong>Copy and close</strong> to copy and dismiss the dialog in one step.</p>

        <ul>
          <li>The dialog displays this warning in red: <strong>SAVE THIS KEY NOW. This is the only time you'll see the complete key.</strong> The full key is displayed once and cannot be retrieved later.</li>
          <li>Under <strong>Key information</strong> you can see the <strong>Key ID</strong>, <strong>Name</strong>, <strong>Created</strong> date, and <strong>Owner</strong> — StackOne only needs the value that is copied by the <strong>Copy</strong> button, not the <strong>Key ID</strong>.</li>
          <li>Store the copied key in a secure location. If you lose it, open the <strong>API keys</strong> section again and use <strong>+ New key</strong> to mint a replacement — the old key cannot be retrieved.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/qvjvrTQfFPbTg9IV/connectors/weightsandbiases/images/custom-config-new-api-key.png?fit=max&auto=format&n=qvjvrTQfFPbTg9IV&q=85&s=8bd2b08d309861e6b747ce1d092bf8ad" alt="Your new API key dialog with the API KEY value and Copy button." width="1280" height="800" data-path="connectors/weightsandbiases/images/custom-config-new-api-key.png" />
      </div>
    </Step>

    <Step title="Paste the API key into StackOne Hub">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In StackOne Hub, paste the copied value into the <strong>W\&B API Key</strong> field. StackOne sends it as a bearer token on every request to the W\&B GraphQL Public API at `https://api.wandb.ai`.</p>

        <ul>
          <li><strong>W\&B API Key</strong> — the value you copied from the <strong>Your new API key</strong> dialog (starts with `wandb_v1_`). The key grants full access to your W\&B account and should be kept secure.</li>
          <li>W\&B API keys have no scopes, permission picker, or expiration — a key inherits the full permissions of the user who minted it, so admin-only operations require an admin account.</li>
          <li>To manage existing keys later, open the avatar menu → <strong>API keys</strong>; from there you can search by name or key ID, mint another <strong>+ New key</strong>, or revoke keys you no longer need.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<div data-whitelabel-hide>
  <h2>Linking the Account from the Hub</h2>

  <Steps>
    <Step title="Navigate to the Hub">
      Use one of the three <a href="/guides/accounts-section#linking-accounts">Linking Account Methods</a> to access the Hub.
    </Step>

    <Step title="Fill out the fields">
      Fill out the following fields using details from your provider:

      <ul>
        <li><strong>W\&B API Key</strong></li>
      </ul>
    </Step>

    <Step title="Connect">
      <ul>
        <li>Click <strong>Connect</strong></li>
        <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
        <li>Once authorization is successful, you will see a confirmation popup</li>
      </ul>
    </Step>
  </Steps>

  <p>If the account linking is successful, you will see the newly linked account in your <a href="/guides/accounts-section">Accounts</a> page.</p>
</div>
