Realtime Sessions Endpoints

Realtime - Sessions API.

Create Client Session

POST /v1/client/sessions#

Create a client session. Requires the create_client_session permission.

201

Successful Response

client_secret#

*ClientSecret

expires_at#

*date-time

object#

string

Default Value: "client.session"

purpose#

*"realtime"

Supported purposes for client sessions.

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/client/sessions \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "model": "mistral-small-latest"
}'

curl https://api.mistral.ai/v1/client/sessions \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "model": "mistral-small-latest"
}'

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: process.env["MISTRAL_API_KEY"] ?? "",
});

async function run() {
  const result = await mistral.realtime.sessions.create({
    purpose: "realtime",
    model: "Ranchero",
  });

  console.log(result);
}

run();

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: process.env["MISTRAL_API_KEY"] ?? "",
});

async function run() {
  const result = await mistral.realtime.sessions.create({
    purpose: "realtime",
    model: "Ranchero",
  });

  console.log(result);
}

run();

201

{
  "client_secret": {
    "expires_at": "2025-12-17T10:25:07.818693Z",
    "value": "approved"
  },
  "expires_at": "2025-12-17T10:25:07.818693Z",
  "purpose": "realtime"
}

{
  "client_secret": {
    "expires_at": "2025-12-17T10:25:07.818693Z",
    "value": "approved"
  },
  "expires_at": "2025-12-17T10:25:07.818693Z",
  "purpose": "realtime"
}