# VoiceDescriptor

> 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/voicedescriptor/
> Summary: OpenAPI request or response schema for VoiceDescriptor, including required fields, defaults, constraints, and linked nested types.

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

The definition of an available voice.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `voiceId` | yes | `string` | The voice identifier. Used in agent definitions and requests. | — |
| `name` | yes | `string` | The human-readable name. | — |
| `category` | no | `string` | The category given by the provider (for example, `premade`). | — |
| `attributes` | no | `object` | Provider-reported, bounded, safe scalar attributes (for example, `gender` or `language` — see `VoiceAttributeNames`). | — |