From 859348c2fcb8624a3e936d66a6ac3c1266e372d3 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 20 Feb 2026 21:22:31 +0000 Subject: [PATCH] Update api-playground/multiple-responses.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api-playground/multiple-responses.mdx | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/api-playground/multiple-responses.mdx b/api-playground/multiple-responses.mdx index e3a8776b7..a7b4589cd 100644 --- a/api-playground/multiple-responses.mdx +++ b/api-playground/multiple-responses.mdx @@ -30,3 +30,29 @@ responses: currencyCode: "GBP" taxRate: 0.20 ``` + +## Audio response examples + +For endpoints that return audio files, you can provide a URL to an audio file in the `examples` property. The API playground will render an interactive audio player instead of a code snippet. + +To configure audio response examples: + +1. Set the content type to an `audio/*` media type (e.g., `audio/mpeg`, `audio/wav`, `audio/ogg`) +2. Provide a valid URL to an audio file as the example value + +```yaml +responses: + "200": + description: Audio file generated successfully + content: + audio/mpeg: + schema: + type: string + format: binary + examples: + sample: + summary: Sample audio output + value: "https://example.com/sample-audio.mp3" +``` + +The audio URL will be embedded in an HTML audio player, allowing users to play the example directly in the documentation.