​

Portkey Admin API

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

​

Understanding the Admin API Ecosystem

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

​

Resource Management

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

​

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:

​

User and Workspace Administration

Beyond resources and analytics, you’ll need to manage who has access to your Portkey environment:

​

Authentication Strategy

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

The key you use determines which operations you can perform. For organization-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

Portkey’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:

​

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 the Portkey Dashboard

The simplest way to create an API key is through the Portkey dashboard:

​

Through the API

You can also create keys programmatically:

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

​

Understanding API Key Capabilities

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

​

Security and Compliance: Audit Logs

For security-conscious organizations, Portkey 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.

​

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:

1. Appropriate role: Ensure you have the right permissions (Org Owner/Admin for Admin API, Workspace Manager for Workspace API)
2. API key: Generate the appropriate key from the Portkey dashboard
3. 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:

​

Need Support?

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