Skip to navigation
API referenceExperts

Edit an expert

Send only the fields to change. baseUpdatedAt (the updatedAt you loaded) makes the save refuse with 409 stale_edit when someone saved in between.

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.

Path parameters

idstringRequired
The expert id.

Request

Fields of an expert that can be created or edited.
namestringOptional<=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.

baseUpdatedAtdatetimeOptional

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
409
Conflict Error
429
Too Many Requests Error