Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

API (Immortal Only)

Build custom integrations with your Delphi using the REST API.

The Delphi API lets you integrate your Digital Mind directly into your own app, platform, or workflow. You have control to the full experience — create conversations, stream responses, manage tags, and track usage through simple HTTP requests.

Visit the Help Center

Base URL: https://api.delphi.ai

Current version: v4. v3 is the older version; the endpoint pages below document v3.

Getting started

1

Create an API key

API access is available on the Immortal plan. Create keys yourself under Developer Platform → API keys, and choose the scopes the key needs.

Important: Store your key securely. It is only shown once and cannot be retrieved later.

2

Authenticate

Include your API key in the x-api-key header on every request:

curl https://api.delphi.ai/v4/content \
  -H "x-api-key: YOUR_API_KEY"
3

Start a conversation

curl -X POST https://api.delphi.ai/v3/conversation \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"user_email": "user@example.com"}'

This returns a conversation_id and the Delphi's initial greeting.

Authentication

All endpoints require an API key passed in the x-api-key header. The key is scoped to a single Delphi — you can only interact with conversations and users belonging to that Delphi.

Header
Value

x-api-key

Your API key

Scopes

Each key only has the permissions you give it. There are 21 scopes, for example contacts:read and content:write. A request that needs a scope the key doesn't have is rejected.

Rate limits

  • 500 requests per day on the standard tier

  • 10,000 requests per day on the automation tier

  • If you exceed the limit, you'll receive a 429 Too Many Requests response

SDK and CLI

  • TypeScript SDK: npm install @delphiai/sdk. TypeScript is the only official SDK.

  • CLI: npm install -g @delphiai/cli, then delphi login.

  • Upload content: POST /v4/content

  • Notify the owner: POST /v4/notify-owner

There's no public MCP server.

Webhooks and Hosted Actions don't need API access and work on every paid plan.

Available endpoints

  • Audience - Store and manage contextual information about users in your audience.

  • Conversations — Create conversations, stream responses, view history, and manage conversation lifecycle.

  • Clone - Retrieve your Delphi's public profile information.

  • Questions — Retrieve suggested questions configured for your Delphi.

  • Tags — Create tags and organize your audience.

  • Usage — Track consumption metrics and access tiers for your users.

  • Voice — Stream voice responses as real-time PCM audio.

  • Search — Search your Delphi's digital mind for relevant chunks or content.

NextAudience

Last updated