SDK

@raconte/node-sdk is the typed TypeScript SDK for the Raconte API. It exposes the same surface as the REST API (interviews and invitations) as typed functions, generated from the public OpenAPI spec, with Zod schemas for validation. It uses the native fetch and ships ESM.

Prefer the CLI for scripts and terminals; use the SDK inside a TypeScript or Node application.

Install

npm install @raconte/node-sdk

Quick start

Create an organization API key from Settings → API, then:

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 and returns { data, error, response } (no throw on HTTP errors), so check error before using data.

createRaconteClient accepts { apiKey }. The key is sent as Authorization: Bearer <key>.

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)

What you can do

• 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, message audio URL.
• Voices: list the catalog and get a preview audio URL (the public, no-auth endpoints you pick a voiceId from).

See the interactive API reference for the full request and response schemas.