Guide

Create Ardent API Key

Overview

Ardent is an AI agent platform that builds its own extensions and helps teams share breakthroughs. API keys are credentials that allow applications and scripts to authenticate and interact with the Ardent platform programmatically. Creating an API key with Admin role permissions grants full access to platform resources—including the ability to manage agents, extensions, and team members. This is essential for production integrations, CI/CD pipelines, and automated workflows that need to interact with Ardent's API on behalf of your organization.

Before you begin

  • You must have an active Ardent account at app.tryardent.com
  • You must be logged into your Ardent organization account
  • You must have Admin or equivalent permissions to create and manage API keys in your organization (typical for workspace owners or admins)
  • Ensure you are on the organization's main dashboard or settings area where API Keys are accessible

Step by step

1
ClickAPI Keys

Navigate to the API Keys section by clicking the 'API Keys' button in the main navigation menu. This takes you to the API key management dashboard where you can view, create, and manage all API credentials for your organization.

Tip. The API Keys section is typically found in the organization's main settings or dashboard navigation. If you're having trouble locating it, look for 'Settings' or 'Organization' menu items.
Step 1
2
ClickCreate API Key

Click the 'Create API Key' button to open the API key creation dialog. This dialog will allow you to configure the key's name and role permissions.

Step 2
3
Clicke.g. Production

Click in the NAME text field (labeled 'e.g. Production') to focus the input field. This is where you will enter the name for your new API key.

Tip. The placeholder text 'e.g. Production' shows an example format. You can use any descriptive name for your key.
Step 3
4
Typee.g. Production

Type 'Production-Test' in the NAME field to name your API key. This name helps you identify the key's purpose and environment when managing multiple API keys.

Tip. Use descriptive names that include the environment (e.g., Production, Staging, Development) and purpose (e.g., 'Integration-Service', 'CI-Pipeline'). This makes it easier to manage and audit your API keys.
5
Click/ Browzer ORGANIZATION Projects Members Billing API Keys Settings Documentation Support Feedback Rahul API KEYS Create API Key Create API Key NAME ROLE Member Create Key Cancel NAME KEY STATUS CREATED EXPIRES Production-Test sk-ard_test_svMt6jZJf...

Click on the ROLE dropdown section (which currently shows 'Member' as the default) to expand the role selection menu. This allows you to change the permissions level for the API key.

Tip. The ROLE dropdown is typically the second dropdown in the creation dialog. The current selection will be highlighted.
Step 5
6
ClickAdmin

Select 'Admin' from the role menu to assign full administrative permissions to this API key. Admin-level keys have complete access to all Ardent platform resources and operations.

Warning. Admin-level API keys have unrestricted access to your Ardent organization. Only assign Admin permissions to trusted applications and services. Treat Admin keys as highly sensitive credentials and rotate them periodically.
Step 6
7
ClickCreate Key

Click the 'Create Key' button to finalize and generate the new API key with the configured name ('Production-Test') and Admin role permissions. The system will generate a unique key string that you can use for authentication.

Warning. After clicking 'Create Key', you will be shown the generated API key string only once. Copy and store it immediately in a secure location (password manager, secrets vault, or configuration file). You cannot retrieve it again if lost.
Step 7
8
Clickbutton

A confirmation dialog or modal may appear showing the newly generated API key. Click the button or icon to acknowledge or close this confirmation. This ensures the key creation process is complete.

Tip. This step may display the full API key value (starting with 'sk-ard_test_'). Copy this value now if you haven't already.
Step 8
9
ClickDone

Click the 'Done' button to close the creation dialog and return to the API Keys management page. The new key 'Production-Test' should now be visible in your list of active API keys.

Tip. After clicking 'Done', verify that your new key appears in the API Keys table with 'Admin' listed in the ROLE column.
Step 9

Confirm it worked

  1. 1You see the newly created API key listed in the API Keys table with the name 'Production-Test'
  2. 2The key's ROLE column displays 'Admin'
  3. 3A key string beginning with 'sk-ard_test_' is visible and can be copied
  4. 4The key's STATUS shows as active and the CREATED timestamp reflects the current date/time

Common issues

Keep reading