Skip to main content
POST
Create a new Mode

Authorizations

Authorization
string
header
required

Token from the discovery file. Required on every endpoint except /health.

Body

application/json
name
string
required

Must not be empty after normalization and must be unique without regard to case. Windows trims boundary whitespace. macOS also normalizes Unicode, trims invisible boundary characters, and rejects names with no visible base character.

preset
string
required

hyper | message | mail | note | meeting | code | custom

language
string
required
model
string
required
punctuation
boolean
required
capitalization
boolean
required
profanityFilter
boolean
required
id
string<uuid>
customInstructions
string | null
userSystemPrompt
string | null
isDefault
boolean | null
isSystemProvided
boolean | null
sortOrder
integer | null

macOS stores values from -32768 through 32767. On create, macOS ignores this input and assigns the next stored order.

createdDate
string<date-time> | null
modifiedDate
string<date-time> | null
languageModel
string | null
cloudTranscriptionModel
string | null
cloudProvider
string | null
postProcessingMode
integer

0 = off, 1 = cloud, 2 = local. macOS rejects all other values.

postProcessingProvider
string | null
englishSpelling
string | null

american | british | australian | canadian. On create, an omitted value is seeded from the system region (Canada → canadian, Australia → australian, UK/IE/IN/SG/ZA/NZ and other British-English regions → british, everything else and an unknown region → american).

useStreamingTranscription
boolean | null
cloudAccuracyTier
string | null

On create, an omitted or empty value resolves to elevenLabsScribeV2.

removeTrailingPeriod
boolean | null
enableScreenOCR
boolean | null
geminiCustomPrompt
string | null
cloudPostProcessingModel
string | null

On create, an omitted or empty value resolves to anthropic:claude-haiku-4-5.

cloudTranscriptionDomain
string | null
localEngine
string | null

Windows only. macOS ignores this key and never returns it. Defaults to whisper on create.

localParakeetModel
string | null

Windows only. macOS ignores this key and never returns it.

localPostProcessingModel
string | null

Windows only. macOS ignores this key and never returns it.

customVocabulary
string[] | null

Windows only. macOS ignores this key and never returns it.

providerType
string | null

Windows only. macOS ignores this key and never returns it.

Response

200 - application/json

Created mode

ok
boolean
mode
object