Skip to main content

​
What is the Admin API?

The Admin API lets you manage your Corti API Console programmatically. It is built for administrators who want to automate account operations.
This Admin API is separate from the Corti API used for speech recognition, text generation, and agentic workflows:
  • Authentication and scope for the Admin API uses email-and-password to obtain a bearer token via /auth/token. This token is only used for API administration.
  • The Admin API endpoints /customers and /users are only enabled and exposed for projects with Embedded Assistant.
Please contact us if you have interest in this functionality or further questions.

​
Use Cases

The following functionality is currently supported by the Admin API:
FeatureFunctionalityScope
AuthenticationAuthenticate user and get access tokenAll projects
Manage CustomersCreate, update, list, and delete customer accounts within your projectProjects with Embedded Assistant
Manage UsersCreate, update, list, and delete users associated with customer accountsProjects with Embedded Assistant
Permissions mirror the Corti API Console - only project admins or owners can create, update, or delete resources.

​
Quickstart

1

Prepare your Corti API Console account

Best practice: use a dedicated service account for Admin API automation. Assign only the minimal required role and rotate credentials regularly.
2

Authenticate and get an access token

Call /auth/token with your Console email and password to obtain a JWT access token. See API Reference: Authenticate user and get access token
curl -X POST https://api.console.corti.app/functions/v1/public/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your-email@example.com",
    "password": "your-password"
  }'
Example response:
{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "tokenType": "bearer",
  "expiresIn": 3600
}
3

Call an endpoint with the token

Include the token in the Authorization header for subsequent requests:
curl -X GET https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
Tokens expire after expiresIn seconds. Once expired, call the auth/token endpoint again to obtain a new token.

​
Top Pages

Authenticate

Obtain an access token

Create customer

Create a new customer in a project

Create user

Create a new user within a customer
Please contact us for support or more information