Skip to content
Qomni

Agents

Create an agent, give it a voice and put it to work: REST for the calls and a WebSocket to talk to it in real time from your app.

Base URL
https://api.qomni.ai/agents/v1
Key
sk_agents_test_…
curl https://api.qomni.ai/agents/v1/calls \
  -H "Authorization: Bearer sk_agents_test_…"

What's new

Events

The CloudEvents envelope every Qomni event shares.

Every event is a CloudEvent 1.0: the same envelope and, inside data, what is specific to each event. id is the idempotency key (it comes from the work, not from chance) and subject is the workspace, so a consumer can drop duplicates and process in order per workspace. Names follow ai.qomni.<domain>.<object>.<action>.v<n>.

Envelope

CloudEvents 1.0 as every qomni event uses it (STYLE.md, events). Each event schema is this envelope plus its type and its data. id is the idempotency key, derived from the work; subject is the workspace slug, so brokers partition by workspace; time is when it happened.

Field Type Detail
specversion
Required
string "1.0"
id
Required
string ≤ 200
source
Required
string Who publishes it, e.g. /cells/co1/agents
type
Required
string
time
Required
string date-time
datacontenttype
Required
string "application/json"
subject
Required
string The workspace slug.
livemode
Optional
boolean CloudEvents extension: false for test-mode work.
traceparent
Optional
string CloudEvents distributed-tracing extension.
data
Required
object

Shared objects

Objects several events carry inside data.

actor

Who or what acted: an agent, a member, an API key (its ID, never the key) or the system.

Field Type Detail
type
Required
string agent, member, api_key, system
id
Required
string
on_behalf_of
Optional
string The member an API key or an approved agent action acts for.

subject

Field Type Detail
type
Required
string agent, conversation, call, phone_number
id
Required
string
Site navigation

New

2 of 7 steps doneNext: the platform in production

Qomni is in private beta

The API and the app are not open yet. See what is done, what is left and how it opens, step by step until the first customer.

Type to search…

↑↓ move↵ openEsc to close