Skip to main content
The Admin API is in beta. Available endpoints and behavior may change.
The Admin API gives Enterprise account admins scope-based, programmatic access to account analytics and administration features. Most endpoints provide read access to account data, while write scopes enable specific operations such as updating budgets. Use the API to build internal reporting, operational workflows, and integrations for your Enterprise account.

​
Who can access the Admin API

The Admin API is available only to account admins on Enterprise accounts. Account admins can create and manage API keys. Workspace admins and other account members cannot access the Admin API or create its keys. To learn more about Enterprise admin roles, see Account and Workspace Admins.

​
Create an API key

1

Open Developer settings

In your Enterprise account, open Settings and select Developer.
2

Create an API key

Select Create API key and choose read-only or read and write access.
3

Store your key securely

Copy the key, which begins with rpl_, and store it in a secure secret manager. Treat it like a password and never share it.
4

Authenticate your integration

Send the key as a Bearer token with your API requests.

​
What you can do

The Admin API uses scopes to control what each key can do:
  • Usage: Read account usage and gross ledger cost, filtered or grouped by workspace, member, project, or time period.
  • Workspaces: Read workspace lists and details, including member and project counts, admins, and creation time.
  • Members: Read account and workspace membership, filtered by role or searched by name, username, or email.
  • Projects: Read projects across team workspaces, filtered by visibility or deployment status, or searched by title, slug, or description.
  • Budgets: Read account budgets, and use the write:budgets scope to update them.
API responses support cursor pagination and include rate-limit headers and an X-Request-Id for request tracking.

​
Building with Replit Agent

You can ask Replit Agent to build a custom dashboard with the Admin API. Describe the account data you want to track, such as usage by workspace or costs by project, and Agent can build the dashboard and its API integration.
1

Open the skill picker

In a Replit project, click the + button next to the chat input and select Use a skill.
2

Select the Admin API skill

Under Replit skills, select Admin API to give Agent the API context and integration guidance.
3

Describe the dashboard

Tell Agent what you want to track and how you want to view it. For example, ask Agent to build a dashboard that shows usage by workspace and cost by project.
4

Add your API key securely

When Agent needs to make API requests, add your Admin API key to your project’s Secrets. Do not paste the key into chat or commit it to your project.

​
API reference

For endpoint details, request parameters, and integration examples, see the Admin API developer documentation.