Voices & Users

User configuration and custom voice management

Endpoints

Method	Path	Description
GET	`/user/configurations/defaults`	Get platform default user settings
GET	`/user/auth/user`	Get the current authenticated user's profile
GET	`/user/configurations/user`	Get current user's configuration
PUT	`/user/configurations/user`	Update current user's configuration
GET	`/user/configurations/user/validate`	Validate user configuration (with TTL caching)
GET	`/user/onboarding-state`	Get user's onboarding progress
PUT	`/user/onboarding-state`	Update onboarding state
GET	`/user/configurations/voices/{provider}`	Search voices for a TTS provider

GET

/user/auth/user

Returns the authenticated user's profile: name, email, organisation, role.

GET

/user/configurations/user

Returns per-user settings including preferred LLM defaults, notification preferences, and UI settings.

PUT

/user/configurations/user

Request body — UserConfigurationRequestResponseSchema: partial update of user-level settings.

GET

/user/configurations/user/validate

Parameter	Type	Required	Description
`validity_ttl_seconds`	integer	Optional	Cache TTL for the validation result. Default: 60

Returns whether the user's configuration is valid and any issues that need resolution.

GET

/user/configurations/voices/{provider}

Parameter	Type	Required	Description
`provider`	string (enum)	Required	TTS provider: elevenlabs, openai, google, deepgram, azure

Parameter	Type	Required	Description
`model`	string	Optional	Filter by TTS model
`language`	string	Optional	Filter by language code (e.g. "en-US")
`q`	string	Optional	Search by voice name
`gender`	string	Optional	Filter by gender: "male", "female", "neutral"
`accent`	string	Optional	Filter by accent (e.g. "american", "british")

Example — search ElevenLabs for British female voices:

bash

curl "https://api.sysevo.io/api/v1/user/configurations/voices/elevenlabs?gender=female&accent=british" \
  -H "X-API-Key: YOUR_API_KEY"

Was this page helpful?