API Keys and Scopes

Developer Tools Overview

Use API keys to integrate AppGram into your applications and automate workflows. Create keys with specific scopes to control access.

Creating an API Key

1. Go to Settings → Organization → Developer
2. Click Create new API key
3. Enter a name to identify the key
4. Select the scopes (permissions) for the key
5. Optionally set an expiration date
6. Click Create
7. Copy the key immediately - you won't see it again!

Understanding Scopes

Scopes define what an API key can access. Common scopes include:

• settings:* - Full access to organization settings
• settings:view - Read-only access to settings
• members:* - Manage organization members
• content:* - Full content access

Always grant the minimum scopes needed for your use case.

Key Security Best Practices

• Never commit API keys to version control
• Store keys securely (environment variables, secret managers)
• Rotate keys regularly
• Revoke unused keys immediately
• Use different keys for different applications

Revoking API Keys

1. Go to the Developer section
2. Find the key you want to revoke
3. Click the revoke button
4. Confirm the action

Once revoked, the key immediately stops working.

API Key Management

View all your API keys, their scopes, creation dates, last used timestamps, and usage counts from the Developer tab.