Skip to main content
You need an active Mintlify account with admin access. Admin API keys are server-side secrets used for Deployments, Agent, and Analytics actions — do not expose them in client-side code.

Find your Project ID

Your Project ID is the unique identifier for your Mintlify project and is required for most API operations.

1

Open Mintlify settings

Sign in to your Mintlify dashboard, then click the Settings icon (gear) in the top left bar.

The Mintlify editor with the Settings gear icon highlighted in the top left bar
2

Open the API keys page

In the settings navigation, under the Workspace section, click API keys.

The settings navigation with API keys highlighted under the Workspace section
3

Copy your Project ID

In the Project section at the top of the page, click Copy project ID next to the Project ID value.

  • The Project ID is a 24-character identifier displayed in this field.
  • Example: 6a7c91e5f3b28d4016a9c2e7
  • Store it securely for use later.
The API keys page showing the Project ID value and the Copy project ID button highlighted

Generating an admin API key

Create an admin API key to authenticate with the Mintlify API for deployment, agent, and analytics operations.

1

Create a new admin key

On the API keys page, in the Admin API keys section, click + Create key.

The Admin API keys section with the Create key button highlighted
2

Configure and create the key

In the Create admin API key dialog, review the key options and click Create key.

  • Expiration: choose how long the key stays valid (defaults to 90 days).
  • Scope: select Read and write.
  • IP allowlist (Optional): leave empty to allow all IPs.
  • Admin API keys begin with the mint_ prefix.
  • The key is only displayed once and cannot be retrieved later, so copy it immediately and store it securely.
The Create admin API key dialog showing Expiration, Scope, and IP allowlist options with the Create key button highlighted

Provide your credentials in StackOne Hub to connect the account.

  • Paste your admin API key into the Admin API Key field.
  • Paste your Project ID into the Project ID field.

Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Admin API Key
  • Project ID
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.