Skip to main content
POST

Authorizations

Authorization
string
header
required

Project API key (sk_api_…).

Body

application/json
name
string
required
Minimum string length: 1
config
object
required

Keys beyond those listed are stored and returned unchanged.

description
string
public
boolean
default:false

Allows anyone to open a browser session against this assistant without an API key.

Response

The created assistant.

realtimeAssistantId
string<uuid>
organizationId
string<uuid>
projectId
string<uuid>
name
string
description
string
config
object

Keys beyond those listed are stored and returned unchanged.

public
boolean
createdAt
string<date-time>
updatedAt
string<date-time>
createdBy
string

Who created the assistant — an API key or a portal user.

updatedBy
string
version
integer

The version this response shows. Every save bumps it, so published numbers skip the saves in between.

Required range: x >= 1