API Keys

API keys are essential credentials that authenticate your requests to Unizo's APIs. This guide walks you through creating, managing, and securing your API keys in the Unizo console.

Single Key for All Services

The same API key can be used across all Unizo services, including Unified APIs, MCP tools, and platform management. You don't need separate keys for different features.

Environment-Specific Keys

API keys are environment-specific and cannot be shared between environments. Each environment (Development, Staging, Production) requires its own set of API keys. See Environment Management for details.

Accessing API keys from Unizo Console

API Key Generation

1. In the Unizo Console, navigate to API Keys from the sidebar.
2. Click the Generate API Key button to create a new API key for your account.
3. The following fields will be automatically generated: API Key, Created date, and Expiry date.

Important

Your API key will only be displayed once! Make sure to copy and store it securely before closing the dialog.

Using your API Key

With Unified APIs

Include your API key in the request headers when making API calls:

const response = await fetch('https://api.unizo.ai/api/v1/scm/repositories', {
  headers: {
    'apiKey': 'YOUR_API_KEY_HERE',
    'integrationId': 'INTEGRATION_ID',
    'Content-Type': 'application/json'
  }
});

With MCP Tools

The same API key authenticates MCP tool usage. Configure your MCP client:

// Initialize MCP client with your API key
const mcpClient = new UnizoMCP({
  apiKey: 'YOUR_API_KEY_HERE',  // Same key as above
  integrationId: 'INTEGRATION_ID'
});

// Use MCP tools for automation
const result = await mcpClient.tools.scm.createPullRequest({
  repository: 'my-repo',
  title: 'Automated update',
  description: 'Updates generated by MCP'
});

With Connect Agent

For service-level integrations using Connect Agent:

// Create session with your API key
const session = await fetch('https://api.unizo.ai/api/v1/platform/consumers/sessions', {
  method: 'POST',
  headers: {
    'apiKey': 'YOUR_API_KEY_HERE',  // Same API key
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    customerKey: 'customer-123',
    sessionType: 'service'
  })
});

Managing Existing Keys

For each API key, you can:

• Regenerate: Create a new key value while maintaining the same key ID
• Revoke: Immediately disable the key by regerating a new key

---

For additional support, contact our team at support@unizo.ai.