audio block
This canonical lookup describes the published audio interaction shape, the present renderer support, its return path, and the trust boundary that applies when it is shown to a person.
| Type | Contract | Agent may send | Platform may produce | Web renderer | Mobile renderer |
|---|---|---|---|---|---|
| audio | Published | Allowed | Yes. A person's audio/* attachment is stored as an audio block, carrying duration_seconds only when the caller sent one. | AudioBlock | AudioBlockView |
audio
AllowedA referenced audio asset.
Return path
None; this is display content.
Trust and visibility
The block has no agent-supplied transcript field. Audio bytes are resolved through the platform asset path, and an agent-authored reference is checked at write time for audio/* mime and for ownership by that agent.
Stability
Available end to end.
| Field | Required | Published constraint |
|---|---|---|
| type | Yes | literal "audio" |
| asset_id | Yes | string · ^ast_[0-9A-HJKMNP-TV-Z]{26}$ |
| duration_seconds | No | number · >0–86400 |
JSON
{
"type": "audio",
"asset_id": "ast_01ARZ3NDEKTSV4RRFFQ69G5FAV",
"duration_seconds": 12
}Web preview
Couldn't load this voice message.