Introduction to the Administration API

Programmatic access to manage your Corti Console account

What is the Admin API?

The Admin API lets you manage your Corti 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 to text, 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:

Feature	Functionality	Scope
Authentication	Authenticate user and get access token	All projects
Manage Customers	Create, update, list, and delete customer accounts within your project	Projects with Embedded Assistant
Manage Users	Create, update, list, and delete users associated with customer accounts	Projects with Embedded Assistant

Permissions mirror the Corti Console - only project admins or owners can create, update, or delete resources.

Quickstart

1. Prepare your Corti Console account

   • Sign up or log in at console.corti.app
   • Ensure your account has a password set

   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": "[e-mail]",
       "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