Enterprise API quickstart

Use a provisioned Enterprise API key to send your first dictation request.

1. Store your Enterprise API key

Monologue provides a long-lived key to approved organizations during onboarding. Store it in a server-side secret manager and expose it to your application as an environment variable:

export MONOLOGUE_ENTERPRISE_API_KEY="mlg_ent_live_..."

Never embed this key in a browser, mobile app, desktop app, source repository, or support message. Client applications must use short-lived client tokens.

2. Send an audio file

curl --request POST \
  --url https://go.monologue.to/v1/enterprise/dictate \
  --header "X-API-Key: $MONOLOGUE_ENTERPRISE_API_KEY" \
  --form source=smart \
  --form audio=@recording.m4a \
  --form language=en \
  --form platform=server

{
  "id": "ce95ce43-81c5-4dc8-9d31-6f08f0999198",
  "text": "Please send the launch update to Avery.",
  "raw_text": "please send the launch update to avery"
}

3. Add relevant context

curl --request POST \
  --url https://go.monologue.to/v1/enterprise/dictate \
  --header "X-API-Key: $MONOLOGUE_ENTERPRISE_API_KEY" \
  --form source=smart \
  --form audio=@recording.m4a \
  --form 'dictionary=Monologue, Avery, Every' \
  --form 'context=<app_name>Slack</app_name><cursor_before>Quick update:</cursor_before>' \
  --form 'extra_instructions=Write a concise, casual Slack message.'

Use dictionary for names and terminology, context for the current surface and nearby text, and extra_instructions for output behavior. Send only what is relevant to this result.