Using API Keys

API keys allow you to integrate TonAIlity with your own applications and workflows.

What Are API Keys?

API keys are unique identifiers that allow external applications to:

• Generate content programmatically
• Access your voice profile
• Integrate with your CMS or tools
• Automate content workflows

Creating an API Key

1. Go to Settings → API Keys
2. Click Create New Key
3. Give it a descriptive name
4. Select scopes (permissions):

- Read Blog Posts: Fetch blog post content

- Write Blog Posts: Create and update blog posts

- Read Content: Fetch generated content

- Generate Content: Create new content via API

1. Optionally set an expiration (in days)
2. Copy the key immediately (it won't be shown again)

Managing Keys

View Active Keys

See all your API keys with:

• Name and creation date
• Key prefix (for identification)
• Scopes (permissions granted)
• Last used timestamp
• Status (active/revoked)

Revoke a Key

If a key is compromised or no longer needed:

1. Find the key in your list
2. Click Revoke
3. Confirm the action
4. The key stops working immediately

Security Best Practices

1. Never share keys publicly or commit to version control
2. Use environment variables to store keys
3. Create separate keys for different applications
4. Revoke unused keys regularly
5. Monitor usage for unexpected activity

API Documentation

For technical integration details:

• Endpoint documentation
• Request/response formats
• Code examples
• Rate limits

Contact support@tonaility.com for API documentation access.