Start 14-day trial

A type-safe conversational AI API

One typed client for inboxes, conversations, contacts, AI agents and knowledge. Developer access is in beta, and custom webhooks are not available yet.

Card required. No charge if you cancel within 14 days. Available to businesses in the UK and US.

  • Typed end to end
  • Server, React and React Native
  • EU and US regions
import { createServerApiClients } from "@masheev/client/server";

// Keep the key on your server, outside browser code and source control.
const apiKey = process.env.MASHEEV_API_KEY;
if (!apiKey) throw new Error("MASHEEV_API_KEY is required");
const { apiClient } = createServerApiClients({
  baseURL: "https://api.masheev.com",
  apiKey,
});
const orgId = "org_123";

// Inputs and outputs are inferred end to end
const { conversations } = await apiClient.conversations.list.query({
  orgId,
  status: "open",
});
const first = conversations[0];
if (first) {
  await apiClient.messages.create.mutate({
    orgId,
    conversationId: first.id,
    role: "agent",
    content: "Thanks for getting in touch. How can we help?",
  });
}

What is the Masheev conversational AI API?

It is the programmable side of Masheev. The @masheev/client package is a type-safe client for the supported resources, including inboxes, conversations, messages, contacts, AI agents, knowledge and escalations, with autocompletion and inference.

Authenticate from your server with an API key or in the browser with a session, and work against the EU or US data region. Entry points cover React, servers and React Native. Custom webhooks are not part of the current beta.

What the client covers

  • Typed end to end

    @masheev/client infers inputs and outputs for inboxes, conversations, messages, contacts, AI agents and knowledge, so you never write response types by hand.

  • API keys or sessions

    Use API-key bearer auth from your server or a session in the browser, with separate entry points for React, servers and Expo. Permissions are scoped to your organization.

  • EU and US data regions

    Data is stored in the region you choose, and contact export and anonymization endpoints help you answer data-subject requests.

  • Programmable AI agents

    Create and configure AI agents over the API, including instructions, knowledge, tools and guardrails, and attach them to your channels.

Frequently asked questions

Build on the API

Create an API key in your workspace and start with the typed client. Developer access is in beta.

Card required. No charge if you cancel within 14 days. Available to businesses in the UK and US.