Create a new customer

curl --request POST \
  --url https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayName": "admin",
  "customerId": "contosohospital",
  "tenantName": "base",
  "region": "eu",
  "isNfr": false,
  "retentionMinutes": 43200
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    displayName: 'admin',
    customerId: 'contosohospital',
    tenantName: 'base',
    region: 'eu',
    isNfr: false,
    retentionMinutes: 43200
  })
};

fetch('https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

using RestSharp;


var options = new RestClientOptions("https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"displayName\": \"admin\",\n  \"customerId\": \"contosohospital\",\n  \"tenantName\": \"base\",\n  \"region\": \"eu\",\n  \"isNfr\": false,\n  \"retentionMinutes\": 43200\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

import requests

url = "https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers"

payload = {
    "displayName": "admin",
    "customerId": "contosohospital",
    "tenantName": "base",
    "region": "eu",
    "isNfr": False,
    "retentionMinutes": 43200
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'displayName' => 'admin',
    'customerId' => 'contosohospital',
    'tenantName' => 'base',
    'region' => 'eu',
    'isNfr' => false,
    'retentionMinutes' => 43200
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers"

	payload := strings.NewReader("{\n  \"displayName\": \"admin\",\n  \"customerId\": \"contosohospital\",\n  \"tenantName\": \"base\",\n  \"region\": \"eu\",\n  \"isNfr\": false,\n  \"retentionMinutes\": 43200\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"displayName\": \"admin\",\n  \"customerId\": \"contosohospital\",\n  \"tenantName\": \"base\",\n  \"region\": \"eu\",\n  \"isNfr\": false,\n  \"retentionMinutes\": 43200\n}")
  .asString();

{
  "displayName": "admin",
  "tenantName": "base",
  "region": "eu",
  "customerId": "contosohospital",
  "isNfr": false,
  "retentionMinutes": 43200,
  "createdAt": "2023-10-01T12:00:00Z"
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

POST

projects

{projectId}

customers

Create a new customer

curl --request POST \
  --url https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayName": "admin",
  "customerId": "contosohospital",
  "tenantName": "base",
  "region": "eu",
  "isNfr": false,
  "retentionMinutes": 43200
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    displayName: 'admin',
    customerId: 'contosohospital',
    tenantName: 'base',
    region: 'eu',
    isNfr: false,
    retentionMinutes: 43200
  })
};

fetch('https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

using RestSharp;


var options = new RestClientOptions("https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n  \"displayName\": \"admin\",\n  \"customerId\": \"contosohospital\",\n  \"tenantName\": \"base\",\n  \"region\": \"eu\",\n  \"isNfr\": false,\n  \"retentionMinutes\": 43200\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

import requests

url = "https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers"

payload = {
    "displayName": "admin",
    "customerId": "contosohospital",
    "tenantName": "base",
    "region": "eu",
    "isNfr": False,
    "retentionMinutes": 43200
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'displayName' => 'admin',
    'customerId' => 'contosohospital',
    'tenantName' => 'base',
    'region' => 'eu',
    'isNfr' => false,
    'retentionMinutes' => 43200
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers"

	payload := strings.NewReader("{\n  \"displayName\": \"admin\",\n  \"customerId\": \"contosohospital\",\n  \"tenantName\": \"base\",\n  \"region\": \"eu\",\n  \"isNfr\": false,\n  \"retentionMinutes\": 43200\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.console.corti.app/functions/v1/public/projects/{projectId}/customers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"displayName\": \"admin\",\n  \"customerId\": \"contosohospital\",\n  \"tenantName\": \"base\",\n  \"region\": \"eu\",\n  \"isNfr\": false,\n  \"retentionMinutes\": 43200\n}")
  .asString();

{
  "displayName": "admin",
  "tenantName": "base",
  "region": "eu",
  "customerId": "contosohospital",
  "isNfr": false,
  "retentionMinutes": 43200,
  "createdAt": "2023-10-01T12:00:00Z"
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

Authorizations

Authorization

string

header

required

JWT access token obtained from the /auth/token endpoint.

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.

Path Parameters

projectId

string

required

Unique identifier of your project in the Corti API Console.

To find it, open your project at console.corti.app, go to Settings, and copy the value from the Project ID field.

Example:

"consoleproject"

Body

application/json

displayName

string

required

Human-readable display name for the customer

Pattern: ^[\w\s\d-_/]+$

Example:

"admin"

customerId

string

required

Unique identifier for the customer

Maximum string length: 64

Pattern: ^[a-z0-9-_]+$

Example:

"contosohospital"

tenantName

string

deprecated

Deprecated. The tenant is inherited from the project's configured tenant.

Maximum string length: 14

Pattern: ^[a-z0-9]+$

Example:

"base"

region

string

deprecated

Deprecated. The region is inherited from the project's configured region. Supplying a mismatched value returns a 400.

Example:

"eu"

isNfr

boolean

Flag indicating if this is a Not-For-Resale (NFR) customer account.

Example:

false

retentionMinutes

integer | null

Data retention period in minutes. When set, interactions older than this value are automatically deleted. Null means no automatic deletion. If omitted, the project's default retention policy is applied.

Required range: x >= 1

Example:

43200

Response

Customer created successfully

displayName

string

required

Human-readable display name for the customer

Pattern: ^[\w\s\d-_/]+$

Example:

"admin"

tenantName

string

default:base

required

The tenant identifier used for multi-tenancy and resource isolation.

Maximum string length: 14

Pattern: ^[a-z0-9]+$

Example:

"base"

region

enum<string>

default:eu

required

Region for the customer's resources

Available options:

eu,

us

customerId

string

required

Unique identifier for the customer

Maximum string length: 64

Pattern: ^[a-z0-9-_]+$

Example:

"contosohospital"

isNfr

boolean

default:false

Flag indicating if this is a Not-For-Resale (NFR) customer account

Example:

false

retentionMinutes

integer | null

Data retention period in minutes. When set, interactions older than this value are automatically deleted. Null means no automatic deletion.

Required range: x >= 1

Example:

43200

createdAt

string<date-time>

Timestamp when the customer was created

Example:

"2023-10-01T12:00:00Z"

⌘I

Web Socket APIs

REST APIs

Agentic APIs v2 (beta)

Agentic APIs v1 (deprecated)

Admin APIs

Corti Models APIs

Errors

Create a new customer

Authorizations

Path Parameters

Body

Response