Skip to navigation
API referenceExperts

List experts

A key limited to some experts sees only those.

Needs the experts:read 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.

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