---
title: "Help Voice"
method: POST
path: "/api/field-app/help/voice"
tags: ["fieldApp"]
---

# Help Voice

`POST /api/field-app/help/voice`

## Request

- Base URL: `https://api.electricair.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.electricair.io/api/field-app/help/voice`
- Auth: HTTP bearer

A short-lived OpenAI Realtime secret for one voice conversation. 503: voice isn't set up.

## Request body

- HelpVoiceRequest
  - `tools` boolean
  - `guide_slug` string
  - `step_number` integer, nullable
  - `controller` boolean

## Response `200`

OK

- VoiceSessionSchema
  - `client_secret` string, required
  - `expires_at` integer, nullable
  - `model` string, required
  - `websocket_url` string, required

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-10-30** `4bfd11cb22ff`: 1 info
  - added the new optional request property `controller`
- **2026-10-30** `2667fc5b11f5`: 1 info
  - added the new optional request property `tools`

[Operation history](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/changes/api/field-app/help/voice/post.md)

---

[API](https://skmtc.dev/electricair/apis/electric-air-autoquote-api.md) - [All operations](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/llms.txt) - [OpenAPI document](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/revisions/a13d832a5676?raw)