AI API

Paginated tenant call log. Admin-only.

Read the calling tenant's AI feature toggles. Returns the "all-off" default when no row exists yet.

Fetch a single AI provider by id. Returns null for unknown ids.

List the AI providers configured for the calling tenant. Returns an empty list when nothing is configured — front-ends use the tenant's plan to decide whether to render the upgrade CTA.

Spend rollup grouped by (provider, feature) over the last days days (default 30). Admin-only.

Save a new AI provider for the calling tenant. Requires the tenant to be on Pro plan or higher; otherwise returns PlanGateNotMet.

Soft-delete an AI provider. The credential blob remains on disk (so audit can reference it) but no further AI calls will use it.

Toggle one or more AI features for the calling tenant. Plan-gated: Pro+ only. Per-feature toggles default off — every AI feature requires explicit opt-in here before it runs.

Promote an AI provider to be the tenant's default. Atomically demotes the previous default if any.

Synthesize speech via the tenant's configured AI provider. Pro+ tenants only; requires voice_tts_enabled toggle.

Round-trip a tiny "ping" prompt through the configured provider to verify the saved key works. Always returns a result object (success or failure) rather than erroring, so the front-end can render the outcome inline next to the provider row. Counts toward the provider's monthly budget like any other call.

Transcribe an audio clip via the tenant's configured AI provider. Pro+ tenants only; requires voice_transcription_enabled toggle.

Translate text to target_language. Plan- and toggle-gated.

Update an existing AI provider. Use this to rotate the API key, rename, change the default model, change the base URL, or activate/deactivate.