AI Gateway Admin API

The AI Gateway Admin API provides programmatic access to manage your organisation, workspaces, and resources. Whether you’re automating routine administration tasks, integrating the AI Gateway with your existing systems, or customizing your deployment at scale, this API gives you the tools to control every aspect of your AI Gateway implementation.

Understanding the Admin API Ecosystem

The Admin API is organized around key capabilities that let you manage different aspects of your AI Gateway environment. Let’s explore what you can build and automate:

Resource Management

At the foundation of the AI Gateway are the resources that define how your AI implementation works. These can all be managed programmatically:

Configs

Create and manage configuration profiles that define routing rules, model settings, and more.

Providers & Integrations

Manage AI providers and credentials across workspaces. Replaces Virtual Keys.

API Keys

Create and manage API keys for accessing AI Gateway services.

Analytics and Monitoring

Once your resources are configured, you’ll want to measure performance and usage. The Admin API gives you powerful tools to access analytics data:

Summary Data

Retrieve aggregated usage statistics and performance metrics.

Grouped Data

Access detailed analytics organized by metadata, model, or user.

Time Series Data

Monitor performance trends, costs, errors, feedback, and usage patterns over time.

Authentication Strategy

Now that you understand what the Admin API can do, let’s explore how to authenticate your requests. The AI Gateway uses a sophisticated access control system with two types of API keys, each designed for different use cases:

Admin API Key

Organisation-wide accessThese keys grant access to administrative operations across your entire organisation.

Only Organisation Owners and Admins can create and manage Admin API keys.

Workspace API Key

Workspace-specific accessThese keys provide targeted access to resources within a single workspace.

Workspace Managers can create and manage Workspace API keys.

The key you use determines which operations you can perform. For organisation-wide administrative tasks, you’ll need an Admin API key. For workspace-specific operations, you can use a Workspace API key.

Access Control and Permissions Model

The AI Gateway’s hierarchical access control system governs who can use which APIs. Let’s examine how roles, API keys, and permissions interact: This access model follows a clear hierarchy:

Role	Can Create Admin API Key	Can Create Workspace API Key	Access Scope
Organisation Owner	✅	✅ (any workspace)	All organisation resources
Organisation Admin	✅	✅ (any workspace)	All organisation resources
Workspace Manager	❌	✅ (managed workspace only)	Single workspace resources
Workspace Member	❌	❌	Limited workspace access

Creating and Managing API Keys

Now that you understand the permission model, let’s look at how to create the API keys you’ll need:

Through Strata Cloud Manager

The simplest way to create an API key is through Strata Cloud Manager:

Through the API

You can also create keys programmatically:

curl -X POST https://aigw.portkey.ai/v1/api-keys/organisation/service
  -H "Authorization: Bearer YOUR_EXISTING_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":"API_KEY_NAME_0809",
    "scopes":[
      "logs.export",
      "logs.list",
      "logs.view"
    ]
  }'

curl -X POST https://aigw.portkey.ai/v1/api-keys/workspace/user \
  -H "Authorization: Bearer YOUR_EXISTING_WORKSPACE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":"API_KEY_NAME_0909",
    "workspace_id":"WORKSPACE_ID",
    "scopes":[
      "virtual_keys.create",
      "virtual_keys.update",
    ]
  }'

Understanding API Key Capabilities

Both key types have different capabilities. This table clarifies which operations each key type can perform:

Operation	Admin API Key	Workspace API Key
Manage organisation settings	✅	❌
Create/manage workspaces	✅	❌
Manage users and permissions	✅	❌
Create/manage configs	✅ (All workspaces)	✅ (Single workspace)
Create/manage providers	✅ (All workspaces)	✅ (Single workspace)
Access Analytics	✅ (All workspaces)	✅ (Single workspace)
Create/update feedback	❌	✅

Security and Compliance: Audit Logs

For security-conscious organisations, the AI Gateway provides comprehensive audit logging of all Admin API operations. These logs give you complete visibility into administrative actions: Every administrative action is recorded with:

User identity
Action type and target resource
Timestamp
IP address
Request details

This audit trail helps maintain compliance and provides accountability for all administrative changes.

Audit Logs Documentation

Learn more about the AI Gateway’s audit logging capabilities

Getting Started with the Admin API

Now that you understand the Admin API ecosystem, authentication, and permissions model, you’re ready to start making requests. Here’s what you’ll need:

Appropriate role: Ensure you have the right permissions (Org Owner/Admin for Admin API, Workspace Manager for Workspace API)
API key: Generate the appropriate key from Strata Cloud Manager
Make your first request: Use your key in the request header

For developers looking to integrate with the Admin API, we provide a complete OpenAPI specification that you can use with your API development tools:

OpenAPI Specification

A single specification covers both the gateway and the Admin API

Need Support?

If you need help setting up or using the Admin API, our team is ready to assist:

Book a Support Call

Schedule time with our team to get personalized help with the Admin API

API Reference

Gateway Configuration

Providers and Credentials

MCP

Administration

Observability

Introduction

AI Gateway Admin API

Understanding the Admin API Ecosystem

Resource Management

Configs

Providers & Integrations

API Keys

Analytics and Monitoring

Summary Data

Grouped Data

Time Series Data

Authentication Strategy

Admin API Key

Workspace API Key

Access Control and Permissions Model

Creating and Managing API Keys

Through Strata Cloud Manager

Through the API

Understanding API Key Capabilities

Security and Compliance: Audit Logs

Audit Logs Documentation

Getting Started with the Admin API

OpenAPI Specification

Need Support?

Book a Support Call

​AI Gateway Admin API

​Understanding the Admin API Ecosystem

​Resource Management

Configs

Providers & Integrations

API Keys

​Analytics and Monitoring

Summary Data

Grouped Data

Time Series Data

​Authentication Strategy

Admin API Key

Workspace API Key

​Access Control and Permissions Model

​Creating and Managing API Keys

​Through Strata Cloud Manager

​Through the API

​Understanding API Key Capabilities

​Security and Compliance: Audit Logs

Audit Logs Documentation

​Getting Started with the Admin API

OpenAPI Specification

​Need Support?

Book a Support Call

AI Gateway Admin API

Understanding the Admin API Ecosystem

Resource Management

Analytics and Monitoring

Authentication Strategy

Access Control and Permissions Model

Creating and Managing API Keys

Through Strata Cloud Manager

Through the API

Understanding API Key Capabilities

Security and Compliance: Audit Logs

Getting Started with the Admin API

Need Support?