Skip to navigation
API referenceExperts

Create an expert

A key limited to some experts cannot create one (it could never see it). Subject to the plan’s expert limit (403 plan_limit).

Sessions: admins.

Needs the experts:write scope. A key without it gets 403 insufficient_scope. Routes not in this reference cannot be called with a key at all (403 not_available_to_api_keys).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

Fields of an expert that can be created or edited.
namestringRequired<=80 characters
descriptionstringOptional
personaPromptstringOptional

May use {{variables}}.

firstMessagestringOptional
voiceConfigmap from strings to anyOptional
Engine, model, voice and experience settings.
toolPolicymap from strings to anyOptional

Per-tool policy overrides.

Response

OK
idstring
A UUID.
orgIdstring
A UUID.
namestring
personaPromptstring
isActiveboolean
visibilityenum
Allowed values:
createdAtdatetime
updatedAtdatetime
descriptionstring or nullOptional
firstMessagestring or nullOptional
avatarUrlstring or nullOptional
backgroundUrlstring or nullOptional
voiceConfigmap from strings to anyOptional
Engine, model, voice and experience settings.
toolPolicymap from strings to anyOptional

Per-tool policy overrides.

slugstring or nullOptional
publishedAtdatetime or nullOptional
widgetConfigmap from strings to anyOptional
Website widget appearance.
interopConfigmap from strings to anyOptional

MCP servers and hand-off specialists; secrets masked.

Errors

401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error