PATCH /api/v2/users/{id}/togglevi
Turns Voice Intelligence (live transcription and real-time assist) on or off for the user's currently active call, optionally setting the transcription locale. Fails if the user has no active call. Reversible by calling again.
Rate limit: 1200 per minute.
Servers
- https://dialpad.com/
- https://sandbox.dialpad.com/
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
Integer | Yes |
The user's id. ('me' can be used if you are using a user level API key) |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
vi_locale |
Null | No |
The locale to use for vi. Valid values:
|
enable_vi |
Boolean | No |
Whether or not call vi should be enabled. |
announce_vi |
Boolean | No |
Whether to play an announcement when vi is toggled for this call. If not provided, falls back to the office's (or group's) transcription-announcement setting. When explicitly set, this also overrides the two-party-consent area-code check that would otherwise suppress the announcement in consent-restricted regions. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.