@voxevolv/server

@voxevolv/server

Server-only TypeScript client for creating and managing VoxEvolv sessions. Never ship this package or its organization API key to a browser.

import { VoxEvolv } from "@voxevolv/server";

const client = new VoxEvolv({
  apiKey: process.env.VOXEVOLV_API_KEY!,
  baseUrl: process.env.VOXEVOLV_API_BASE!,
});
const session = await client.sessions.create({
  intentId: interviewSessionId,
  profile: "live-interviewer",
  participant: { identity: userId, displayName },
  instructions,
  greeting,
});

return session.browserCredentials();

intentId is converted to one deterministic idempotency key. Retryable network, 429, and 5xx failures reuse that exact key. API failures throw VoxEvolvError with the HTTP status, VoxEvolv error code, request ID, details, and retryability.