# SpeakRequest

> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/http-api/schemas/speakrequest/
> Summary: OpenAPI request or response schema for SpeakRequest, including required fields, defaults, constraints, and linked nested types.

[← All HTTP schemas](/http-api/schemas/)

A speech synthesis request as an operator action.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `text` | yes | `string` | The text to speak. | — |
| `sessionId` | no | `string` | The session the attachment is bound to. If left empty, the attachment is considered orphaned and deleted by the retention policy. | — |
| `voiceId` | no | `string` | The identifier of the voice to use. The default voice if empty. | — |
| `includeTimestamps` | no | `boolean` | Requests character-level timing alongside the audio. Default `false`. | — |
| `provider` | no | `string` | The registration name of the synthesizer to use; `null` for the default one. | — |