@raconte/node-sdk

Typed TypeScript SDK for the public Raconte API: create and manage AI voice interviews and their invitations.

The SDK is generated from the public OpenAPI spec (the routes authenticated with an organization API key, the same surface exposed by the MCP server). It uses the native fetch, ships ESM, and works in Node and any modern runtime.

Install

npm install @raconte/node-sdk
# or: pnpm add @raconte/node-sdk

Authentication

Create an organization API key in Settings, API on raconte.ai. Pass it to createRaconteClient:

import { createRaconteClient, interviewsControllerList } from '@raconte/node-sdk'

const client = createRaconteClient({ apiKey: process.env.RACONTE_API_KEY! })

const { data, error } = await interviewsControllerList({ client })
if (error)
  throw new Error(`Request failed: ${JSON.stringify(error)}`)

console.log(data)

Every SDK function takes the client through its client option. Calls return { data, error, response } (no throw on HTTP errors); check error before using data.

What you can do

The SDK covers interviews, their invitations and the voice catalog:

• Interviews: list, create, get, update, archive, restore, logs, regenerate intro / first message.
• Invitations: list, create, create in bulk, get, update, send, cancel, reactivate, archive, restore, logs, get a message audio URL.
• Voices: list the catalog and get a preview audio URL (the public, no-auth endpoints you pick a voiceId from).

Function names mirror the API operation IDs, for example interviewsControllerCreate, interviewInvitationsControllerSend.

Validation schemas

Zod schemas for every request and response are available from the /zod subpath:

import { zCreateInterviewSchema } from '@raconte/node-sdk/zod'

const input = zCreateInterviewSchema.parse(payload)

Generation

This package is generated, do not edit src/generated/. The source is the public OpenAPI snapshot at apps/website/public/openapi.json. Regenerate from the repo root:

pnpm generate

which refreshes the public spec and then this SDK. To regenerate only the SDK from the current snapshot:

pnpm --filter @raconte/node-sdk generate