API Keys

Create, manage, and secure your agntdata API keys.

Creating API Keys

API keys are created from the agntdata dashboard. Each key is associated with a workspace and shares that workspace’s credit balance.

1. Log in to the Dashboard

   Go to app.agntdata.dev and sign in to your account.

2. Navigate to API Keys

   From the dashboard sidebar, click on API Keys.

3. Create New Key

   Click Create API Key, give it a descriptive name (e.g., “Production Server” or “Development”), and click Create.

4. Copy Your Key

   Your new API key will be displayed once. Copy it immediately and store it securely — you won’t be able to see it again.

API keys are shown only once when created. If you lose a key, you’ll need to create a new one.

Managing Keys

Viewing Keys

The API Keys page shows all keys for your workspace:

Column	Description
Name	The descriptive name you assigned
Created	When the key was created
Last Used	Most recent API call with this key
Status	Active or Revoked

Revoking Keys

To revoke an API key:

1. Find the key in the API Keys list
2. Click the Revoke button
3. Confirm the action

Revoking a key is immediate and permanent. Any applications using that key will immediately lose access.

Key Naming Best Practices

Use descriptive names that help you identify where each key is used:

Good Names

• Production API Server
• Development Local
• CI/CD Pipeline
• Analytics Service

Avoid

• Key 1
• Test
• My Key
• asdf

Multiple Keys

You can create multiple API keys for a single workspace. Common patterns:

Environment Separation

Create separate keys for development, staging, and production. This lets you revoke a compromised dev key without affecting production.

Service Isolation

Give each service or application its own key. If one service is compromised, you can revoke just that key.

Team Members

Create individual keys for team members during development. Revoke them when someone leaves the team.

Key Rotation

Periodically rotating API keys is a security best practice:

1. Create New Key

   Create a new API key with a descriptive name like “Production Server (Rotated April 2024)”.

2. Update Applications

   Update all applications to use the new key. Verify they’re working correctly.

3. Revoke Old Key

   Once all applications are using the new key, revoke the old one.

Next Steps

Authentication Overview

Learn how authentication works with the API.

Quickstart

Make your first API request.