MOmoda
voices

Put Voice Favorite

Changed on

Add or remove a favorite; is_default sets the workspace default voice.

Any team member may write workspace favorites. Removing a favorite that does not exist is 200; favoriting a revoked voice is 409 voice_unavailable.

put/voice-favorites

Request

  • Base URL
    https://api.moda.app/v1
  • URL
    https://api.moda.app/v1/voice-favorites
  • Auth
    HTTP bearer

Headers

X-Voice-Enginesstring nullable

The voice engines this client understands, comma-separated: elevenlabs,fishaudio,inworld. ElevenLabs is always on; Fish Audio models and voices appear only for a client that lists fishaudio (or, on GET /v1/voices, asks for provider=fishaudio or a featured/community category), and Inworld's only for a client that lists inworld (or asks for provider=inworld).

Moda-Version'2026-04-12' | '2026-05-01'
Example:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Request body

voicestring required
scope'user' | 'workspace' required
favoriteboolean
is_defaultboolean

Example request

{
  "scope": "workspace"
}

Response

Successful Response

object'voice_favorite'
voicestring required
scope'user' | 'workspace' required
favoriteboolean required
is_defaultboolean required
updated_atstring required

Changes