@seamapi/types 1.1125.0 → 1.1127.0

package/lib/seam/connect/openapi.js

@@ -10430,6 +10430,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of setting the volume on a speaker.',
                                 enum: ['SET_SPEAKER_VOLUME'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Errors associated with the action attempt. Null for pending action attempts.',
@@ -10449,6 +10450,7 @@ const openapi = {
                             'action_type',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Setting the speaker volume succeeded.',
@@ -10462,6 +10464,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of setting the volume on a speaker.',
                                 enum: ['SET_SPEAKER_VOLUME'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Errors associated with the action attempt. Null for successful action attempts.',
@@ -10482,6 +10485,7 @@ const openapi = {
                             'result',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Setting the speaker volume failed.',
@@ -10495,6 +10499,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of setting the volume on a speaker.',
                                 enum: ['SET_SPEAKER_VOLUME'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Error associated with the action.',
@@ -10522,6 +10527,7 @@ const openapi = {
                             'error',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Muting or unmuting the speaker is pending.',
@@ -10535,6 +10541,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of muting or unmuting a speaker.',
                                 enum: ['SET_SPEAKER_MUTE'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Errors associated with the action attempt. Null for pending action attempts.',
@@ -10554,6 +10561,7 @@ const openapi = {
                             'action_type',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Muting or unmuting the speaker succeeded.',
@@ -10567,6 +10575,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of muting or unmuting a speaker.',
                                 enum: ['SET_SPEAKER_MUTE'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Errors associated with the action attempt. Null for successful action attempts.',
@@ -10587,6 +10596,7 @@ const openapi = {
                             'result',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Muting or unmuting the speaker failed.',
@@ -10600,6 +10610,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of muting or unmuting a speaker.',
                                 enum: ['SET_SPEAKER_MUTE'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Error associated with the action.',
@@ -10627,6 +10638,7 @@ const openapi = {
                             'error',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Pausing playback on the speaker is pending.',
@@ -10640,6 +10652,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of pausing playback on a speaker.',
                                 enum: ['PAUSE_SPEAKER_PLAYBACK'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Errors associated with the action attempt. Null for pending action attempts.',
@@ -10659,6 +10672,7 @@ const openapi = {
                             'action_type',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Pausing playback on the speaker succeeded.',
@@ -10672,6 +10686,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of pausing playback on a speaker.',
                                 enum: ['PAUSE_SPEAKER_PLAYBACK'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Errors associated with the action attempt. Null for successful action attempts.',
@@ -10699,6 +10714,7 @@ const openapi = {
                             'result',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Pausing playback on the speaker failed.',
@@ -10712,6 +10728,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of pausing playback on a speaker.',
                                 enum: ['PAUSE_SPEAKER_PLAYBACK'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Error associated with the action.',
@@ -10739,6 +10756,7 @@ const openapi = {
                             'error',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Resuming playback on the speaker is pending.',
@@ -10752,6 +10770,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of resuming playback on a speaker.',
                                 enum: ['RESUME_SPEAKER_PLAYBACK'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Errors associated with the action attempt. Null for pending action attempts.',
@@ -10771,6 +10790,7 @@ const openapi = {
                             'action_type',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Resuming playback on the speaker succeeded.',
@@ -10784,6 +10804,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of resuming playback on a speaker.',
                                 enum: ['RESUME_SPEAKER_PLAYBACK'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Errors associated with the action attempt. Null for successful action attempts.',
@@ -10811,6 +10832,7 @@ const openapi = {
                             'result',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Resuming playback on the speaker failed.',
@@ -10824,6 +10846,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of resuming playback on a speaker.',
                                 enum: ['RESUME_SPEAKER_PLAYBACK'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Error associated with the action.',
@@ -10851,6 +10874,7 @@ const openapi = {
                             'error',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Playing a chime on the speaker is pending.',
@@ -10864,6 +10888,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of playing a chime on a speaker.',
                                 enum: ['PLAY_SPEAKER_CHIME'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Errors associated with the action attempt. Null for pending action attempts.',
@@ -10883,6 +10908,7 @@ const openapi = {
                             'action_type',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Playing a chime on the speaker succeeded.',
@@ -10896,6 +10922,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of playing a chime on a speaker.',
                                 enum: ['PLAY_SPEAKER_CHIME'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Errors associated with the action attempt. Null for successful action attempts.',
@@ -10916,6 +10943,7 @@ const openapi = {
                             'result',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         description: 'Playing a chime on the speaker failed.',
@@ -10929,6 +10957,7 @@ const openapi = {
                                 description: 'Action attempt to track the status of playing a chime on a speaker.',
                                 enum: ['PLAY_SPEAKER_CHIME'],
                                 type: 'string',
+                                'x-undocumented': 'Unreleased.',
                             },
                             error: {
                                 description: 'Error associated with the action.',
@@ -10956,6 +10985,236 @@ const openapi = {
                             'error',
                         ],
                         type: 'object',
+                        'x-undocumented': 'Unreleased.',
+                    },
+                    {
+                        description: 'Playing a favorite on the speaker is pending.',
+                        properties: {
+                            action_attempt_id: {
+                                description: 'ID of the action attempt.',
+                                format: 'uuid',
+                                type: 'string',
+                            },
+                            action_type: {
+                                description: 'Action attempt to track the status of playing a favorite on a speaker.',
+                                enum: ['PLAY_SPEAKER_FAVORITE'],
+                                type: 'string',
+                                'x-undocumented': 'Unreleased.',
+                            },
+                            error: {
+                                description: 'Errors associated with the action attempt. Null for pending action attempts.',
+                                nullable: true,
+                            },
+                            result: {
+                                description: 'Result of the action attempt. Null for pending action attempts.',
+                                nullable: true,
+                            },
+                            status: { enum: ['pending'], type: 'string' },
+                        },
+                        required: [
+                            'action_attempt_id',
+                            'status',
+                            'result',
+                            'error',
+                            'action_type',
+                        ],
+                        type: 'object',
+                        'x-undocumented': 'Unreleased.',
+                    },
+                    {
+                        description: 'Playing a favorite on the speaker succeeded.',
+                        properties: {
+                            action_attempt_id: {
+                                description: 'ID of the action attempt.',
+                                format: 'uuid',
+                                type: 'string',
+                            },
+                            action_type: {
+                                description: 'Action attempt to track the status of playing a favorite on a speaker.',
+                                enum: ['PLAY_SPEAKER_FAVORITE'],
+                                type: 'string',
+                                'x-undocumented': 'Unreleased.',
+                            },
+                            error: {
+                                description: 'Errors associated with the action attempt. Null for successful action attempts.',
+                                nullable: true,
+                            },
+                            result: {
+                                description: 'Result of the action.',
+                                properties: {
+                                    affected_device_ids: {
+                                        description: 'IDs of the speakers now playing the favorite, including speakers grouped with the requested speaker.',
+                                        items: { format: 'uuid', type: 'string' },
+                                        type: 'array',
+                                    },
+                                },
+                                required: ['affected_device_ids'],
+                                type: 'object',
+                            },
+                            status: { enum: ['success'], type: 'string' },
+                        },
+                        required: [
+                            'action_attempt_id',
+                            'status',
+                            'error',
+                            'action_type',
+                            'result',
+                        ],
+                        type: 'object',
+                        'x-undocumented': 'Unreleased.',
+                    },
+                    {
+                        description: 'Playing a favorite on the speaker failed.',
+                        properties: {
+                            action_attempt_id: {
+                                description: 'ID of the action attempt.',
+                                format: 'uuid',
+                                type: 'string',
+                            },
+                            action_type: {
+                                description: 'Action attempt to track the status of playing a favorite on a speaker.',
+                                enum: ['PLAY_SPEAKER_FAVORITE'],
+                                type: 'string',
+                                'x-undocumented': 'Unreleased.',
+                            },
+                            error: {
+                                description: 'Error associated with the action.',
+                                properties: {
+                                    message: {
+                                        description: 'Detailed description of the error. Provides insights into the issue and potentially how to rectify it.',
+                                        type: 'string',
+                                    },
+                                    type: { description: 'Type of the error.', type: 'string' },
+                                },
+                                required: ['type', 'message'],
+                                type: 'object',
+                            },
+                            result: {
+                                description: 'Result of the action attempt. Null for failed action attempts.',
+                                nullable: true,
+                            },
+                            status: { enum: ['error'], type: 'string' },
+                        },
+                        required: [
+                            'action_attempt_id',
+                            'status',
+                            'result',
+                            'action_type',
+                            'error',
+                        ],
+                        type: 'object',
+                        'x-undocumented': 'Unreleased.',
+                    },
+                    {
+                        description: 'Playing an audio clip on the speaker is pending.',
+                        properties: {
+                            action_attempt_id: {
+                                description: 'ID of the action attempt.',
+                                format: 'uuid',
+                                type: 'string',
+                            },
+                            action_type: {
+                                description: 'Action attempt to track the status of playing an audio clip on a speaker.',
+                                enum: ['PLAY_SPEAKER_AUDIO_CLIP'],
+                                type: 'string',
+                                'x-undocumented': 'Unreleased.',
+                            },
+                            error: {
+                                description: 'Errors associated with the action attempt. Null for pending action attempts.',
+                                nullable: true,
+                            },
+                            result: {
+                                description: 'Result of the action attempt. Null for pending action attempts.',
+                                nullable: true,
+                            },
+                            status: { enum: ['pending'], type: 'string' },
+                        },
+                        required: [
+                            'action_attempt_id',
+                            'status',
+                            'result',
+                            'error',
+                            'action_type',
+                        ],
+                        type: 'object',
+                        'x-undocumented': 'Unreleased.',
+                    },
+                    {
+                        description: 'Playing an audio clip on the speaker succeeded.',
+                        properties: {
+                            action_attempt_id: {
+                                description: 'ID of the action attempt.',
+                                format: 'uuid',
+                                type: 'string',
+                            },
+                            action_type: {
+                                description: 'Action attempt to track the status of playing an audio clip on a speaker.',
+                                enum: ['PLAY_SPEAKER_AUDIO_CLIP'],
+                                type: 'string',
+                                'x-undocumented': 'Unreleased.',
+                            },
+                            error: {
+                                description: 'Errors associated with the action attempt. Null for successful action attempts.',
+                                nullable: true,
+                            },
+                            result: {
+                                description: 'Result of the action.',
+                                properties: {},
+                                type: 'object',
+                            },
+                            status: { enum: ['success'], type: 'string' },
+                        },
+                        required: [
+                            'action_attempt_id',
+                            'status',
+                            'error',
+                            'action_type',
+                            'result',
+                        ],
+                        type: 'object',
+                        'x-undocumented': 'Unreleased.',
+                    },
+                    {
+                        description: 'Playing an audio clip on the speaker failed.',
+                        properties: {
+                            action_attempt_id: {
+                                description: 'ID of the action attempt.',
+                                format: 'uuid',
+                                type: 'string',
+                            },
+                            action_type: {
+                                description: 'Action attempt to track the status of playing an audio clip on a speaker.',
+                                enum: ['PLAY_SPEAKER_AUDIO_CLIP'],
+                                type: 'string',
+                                'x-undocumented': 'Unreleased.',
+                            },
+                            error: {
+                                description: 'Error associated with the action.',
+                                properties: {
+                                    message: {
+                                        description: 'Detailed description of the error. Provides insights into the issue and potentially how to rectify it.',
+                                        type: 'string',
+                                    },
+                                    type: { description: 'Type of the error.', type: 'string' },
+                                },
+                                required: ['type', 'message'],
+                                type: 'object',
+                            },
+                            result: {
+                                description: 'Result of the action attempt. Null for failed action attempts.',
+                                nullable: true,
+                            },
+                            status: { enum: ['error'], type: 'string' },
+                        },
+                        required: [
+                            'action_attempt_id',
+                            'status',
+                            'result',
+                            'action_type',
+                            'error',
+                        ],
+                        type: 'object',
+                        'x-undocumented': 'Unreleased.',
                     },
                     {
                         properties: {
@@ -13293,14 +13552,27 @@ const openapi = {
                     can_mute_speaker: {
                         description: 'Indicates whether the speaker supports muting.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_pause_speaker_playback: {
                         description: 'Indicates whether the speaker supports pausing playback.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
+                    },
+                    can_play_speaker_audio_clip: {
+                        description: 'Indicates whether the speaker supports playing an audio clip from a URL.',
+                        type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_play_speaker_chime: {
                         description: 'Indicates whether the speaker supports playing a chime.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
+                    },
+                    can_play_speaker_favorite: {
+                        description: "Indicates whether the speaker supports listing and playing the favorites saved in the speaker manufacturer's app, such as playlists and radio stations.",
+                        type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_program_offline_access_codes: {
                         description: 'Indicates whether the device supports programming offline access codes.',
@@ -13333,6 +13605,7 @@ const openapi = {
                     can_resume_speaker_playback: {
                         description: 'Indicates whether the speaker supports resuming playback.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_run_thermostat_programs: {
                         description: 'Indicates whether the thermostat supports running climate programs.',
@@ -13341,6 +13614,7 @@ const openapi = {
                     can_set_speaker_volume: {
                         description: 'Indicates whether the speaker supports setting its volume.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_simulate_connection: {
                         description: 'Indicates whether the device supports simulating connection in a sandbox.',
@@ -13381,6 +13655,7 @@ const openapi = {
                     can_unmute_speaker: {
                         description: 'Indicates whether the speaker supports unmuting.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     capabilities_supported: {
                         description: '\n        Collection of capabilities that the device supports when connected to Seam. Values are `access_code`, which indicates that the device can manage and utilize digital PIN codes for secure access; `lock`, which indicates that the device controls a door locking mechanism, enabling the remote opening and closing of doors and other entry points; `noise_detection`, which indicates that the device supports monitoring and responding to ambient noise levels; `thermostat`, which indicates that the device can regulate and adjust indoor temperatures; `battery`, which indicates that the device can manage battery life and health; and `phone`, which indicates that the device is a mobile device, such as a smartphone. **Important:** Superseded by [capability flags](https://www.seam.co/docs/capability-guides/device-and-system-capabilities#capability-flags).\n        ',
@@ -15413,6 +15688,7 @@ const openapi = {
                                                     },
                                                 },
                                                 type: 'object',
+                                                'x-undocumented': 'Unreleased.',
                                             },
                                             tado_metadata: {
                                                 description: 'Metadata for a tado° device.',
@@ -15981,7 +16257,7 @@ const openapi = {
                                                         type: 'string',
                                                     },
                                                     supports_chime: {
-                                                        description: 'Indicates whether the speaker can play a chime.',
+                                                        description: 'Indicates whether the speaker can play a chime or an audio clip.',
                                                         type: 'boolean',
                                                     },
                                                     volume: {
@@ -16013,6 +16289,7 @@ const openapi = {
                                                 ],
                                                 type: 'object',
                                                 'x-property-group-key': 'speakers',
+                                                'x-undocumented': 'Unreleased.',
                                             },
                                             supported_code_lengths: {
                                                 description: 'Supported code lengths for access codes.',
@@ -17512,14 +17789,27 @@ const openapi = {
                     can_mute_speaker: {
                         description: 'Indicates whether the speaker supports muting.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_pause_speaker_playback: {
                         description: 'Indicates whether the speaker supports pausing playback.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
+                    },
+                    can_play_speaker_audio_clip: {
+                        description: 'Indicates whether the speaker supports playing an audio clip from a URL.',
+                        type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_play_speaker_chime: {
                         description: 'Indicates whether the speaker supports playing a chime.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
+                    },
+                    can_play_speaker_favorite: {
+                        description: "Indicates whether the speaker supports listing and playing the favorites saved in the speaker manufacturer's app, such as playlists and radio stations.",
+                        type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_program_offline_access_codes: {
                         description: 'Indicates whether the device supports programming offline access codes.',
@@ -17552,6 +17842,7 @@ const openapi = {
                     can_resume_speaker_playback: {
                         description: 'Indicates whether the speaker supports resuming playback.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_run_thermostat_programs: {
                         description: 'Indicates whether the thermostat supports running climate programs.',
@@ -17560,6 +17851,7 @@ const openapi = {
                     can_set_speaker_volume: {
                         description: 'Indicates whether the speaker supports setting its volume.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_simulate_connection: {
                         description: 'Indicates whether the device supports simulating connection in a sandbox.',
@@ -17600,6 +17892,7 @@ const openapi = {
                     can_unmute_speaker: {
                         description: 'Indicates whether the speaker supports unmuting.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     device_provider_name: {
                         description: 'Name of the device provider.',
@@ -35502,14 +35795,27 @@ const openapi = {
                     can_mute_speaker: {
                         description: 'Indicates whether the speaker supports muting.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_pause_speaker_playback: {
                         description: 'Indicates whether the speaker supports pausing playback.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
+                    },
+                    can_play_speaker_audio_clip: {
+                        description: 'Indicates whether the speaker supports playing an audio clip from a URL.',
+                        type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_play_speaker_chime: {
                         description: 'Indicates whether the speaker supports playing a chime.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
+                    },
+                    can_play_speaker_favorite: {
+                        description: "Indicates whether the speaker supports listing and playing the favorites saved in the speaker manufacturer's app, such as playlists and radio stations.",
+                        type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_program_offline_access_codes: {
                         description: 'Indicates whether the device supports programming offline access codes.',
@@ -35542,6 +35848,7 @@ const openapi = {
                     can_resume_speaker_playback: {
                         description: 'Indicates whether the speaker supports resuming playback.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_run_thermostat_programs: {
                         description: 'Indicates whether the thermostat supports running climate programs.',
@@ -35550,6 +35857,7 @@ const openapi = {
                     can_set_speaker_volume: {
                         description: 'Indicates whether the speaker supports setting its volume.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     can_simulate_connection: {
                         description: 'Indicates whether the device supports simulating connection in a sandbox.',
@@ -35590,6 +35898,7 @@ const openapi = {
                     can_unmute_speaker: {
                         description: 'Indicates whether the speaker supports unmuting.',
                         type: 'boolean',
+                        'x-undocumented': 'Unreleased.',
                     },
                     capabilities_supported: {
                         description: '\n        Collection of capabilities that the device supports when connected to Seam. Values are `access_code`, which indicates that the device can manage and utilize digital PIN codes for secure access; `lock`, which indicates that the device controls a door locking mechanism, enabling the remote opening and closing of doors and other entry points; `noise_detection`, which indicates that the device supports monitoring and responding to ambient noise levels; `thermostat`, which indicates that the device can regulate and adjust indoor temperatures; `battery`, which indicates that the device can manage battery life and health; and `phone`, which indicates that the device is a mobile device, such as a smartphone. **Important:** Superseded by [capability flags](https://www.seam.co/docs/capability-guides/device-and-system-capabilities#capability-flags).\n        ',
@@ -49477,6 +49786,8 @@ const openapi = {
                                     'can_pause_speaker_playback',
                                     'can_resume_speaker_playback',
                                     'can_play_speaker_chime',
+                                    'can_play_speaker_favorite',
+                                    'can_play_speaker_audio_clip',
                                 ],
                                 type: 'string',
                             },
@@ -49518,6 +49829,8 @@ const openapi = {
                                     'can_pause_speaker_playback',
                                     'can_resume_speaker_playback',
                                     'can_play_speaker_chime',
+                                    'can_play_speaker_favorite',
+                                    'can_play_speaker_audio_clip',
                                 ],
                                 type: 'string',
                             },
@@ -51757,6 +52070,8 @@ const openapi = {
                                     'can_pause_speaker_playback',
                                     'can_resume_speaker_playback',
                                     'can_play_speaker_chime',
+                                    'can_play_speaker_favorite',
+                                    'can_play_speaker_audio_clip',
                                 ],
                                 type: 'string',
                             },
@@ -51798,6 +52113,8 @@ const openapi = {
                                     'can_pause_speaker_playback',
                                     'can_resume_speaker_playback',
                                     'can_play_speaker_chime',
+                                    'can_play_speaker_favorite',
+                                    'can_play_speaker_audio_clip',
                                 ],
                                 type: 'string',
                             },
@@ -57926,7 +58243,36 @@ const openapi = {
                                                                         },
                                                                         speakers: {
                                                                             properties: {
+                                                                                play_audio_clip: {
+                                                                                    properties: {
+                                                                                        audio_url: {
+                                                                                            description: 'Public HTTPS URL of the MP3 or WAV file to play. The speaker downloads the file itself.',
+                                                                                            format: 'uri',
+                                                                                            maxLength: 2048,
+                                                                                            pattern: '^https:\\/\\/',
+                                                                                            type: 'string',
+                                                                                        },
+                                                                                        volume: {
+                                                                                            maximum: 100,
+                                                                                            minimum: 0,
+                                                                                            type: 'integer',
+                                                                                        },
+                                                                                    },
+                                                                                    required: ['audio_url'],
+                                                                                    type: 'object',
+                                                                                },
                                                                                 play_chime: { type: 'boolean' },
+                                                                                play_favorite: {
+                                                                                    properties: {
+                                                                                        favorite_id: {
+                                                                                            minLength: 1,
+                                                                                            type: 'string',
+                                                                                        },
+                                                                                        shuffle: { type: 'boolean' },
+                                                                                    },
+                                                                                    required: ['favorite_id'],
+                                                                                    type: 'object',
+                                                                                },
                                                                                 set_volume_to: {
                                                                                     maximum: 100,
                                                                                     minimum: 0,
@@ -58421,7 +58767,36 @@ const openapi = {
                                                                     },
                                                                     speakers: {
                                                                         properties: {
+                                                                            play_audio_clip: {
+                                                                                properties: {
+                                                                                    audio_url: {
+                                                                                        description: 'Public HTTPS URL of the MP3 or WAV file to play. The speaker downloads the file itself.',
+                                                                                        format: 'uri',
+                                                                                        maxLength: 2048,
+                                                                                        pattern: '^https:\\/\\/',
+                                                                                        type: 'string',
+                                                                                    },
+                                                                                    volume: {
+                                                                                        maximum: 100,
+                                                                                        minimum: 0,
+                                                                                        type: 'integer',
+                                                                                    },
+                                                                                },
+                                                                                required: ['audio_url'],
+                                                                                type: 'object',
+                                                                            },
                                                                             play_chime: { type: 'boolean' },
+                                                                            play_favorite: {
+                                                                                properties: {
+                                                                                    favorite_id: {
+                                                                                        minLength: 1,
+                                                                                        type: 'string',
+                                                                                    },
+                                                                                    shuffle: { type: 'boolean' },
+                                                                                },
+                                                                                required: ['favorite_id'],
+                                                                                type: 'object',
+                                                                            },
                                                                             set_volume_to: {
                                                                                 maximum: 100,
                                                                                 minimum: 0,
@@ -59820,7 +60195,36 @@ const openapi = {
                                                                                 },
                                                                                 speakers: {
                                                                                     properties: {
+                                                                                        play_audio_clip: {
+                                                                                            properties: {
+                                                                                                audio_url: {
+                                                                                                    description: 'Public HTTPS URL of the MP3 or WAV file to play. The speaker downloads the file itself.',
+                                                                                                    format: 'uri',
+                                                                                                    maxLength: 2048,
+                                                                                                    pattern: '^https:\\/\\/',
+                                                                                                    type: 'string',
+                                                                                                },
+                                                                                                volume: {
+                                                                                                    maximum: 100,
+                                                                                                    minimum: 0,
+                                                                                                    type: 'integer',
+                                                                                                },
+                                                                                            },
+                                                                                            required: ['audio_url'],
+                                                                                            type: 'object',
+                                                                                        },
                                                                                         play_chime: { type: 'boolean' },
+                                                                                        play_favorite: {
+                                                                                            properties: {
+                                                                                                favorite_id: {
+                                                                                                    minLength: 1,
+                                                                                                    type: 'string',
+                                                                                                },
+                                                                                                shuffle: { type: 'boolean' },
+                                                                                            },
+                                                                                            required: ['favorite_id'],
+                                                                                            type: 'object',
+                                                                                        },
                                                                                         set_volume_to: {
                                                                                             maximum: 100,
                                                                                             minimum: 0,
@@ -60242,7 +60646,36 @@ const openapi = {
                                                                     },
                                                                     speakers: {
                                                                         properties: {
+                                                                            play_audio_clip: {
+                                                                                properties: {
+                                                                                    audio_url: {
+                                                                                        description: 'Public HTTPS URL of the MP3 or WAV file to play. The speaker downloads the file itself.',
+                                                                                        format: 'uri',
+                                                                                        maxLength: 2048,
+                                                                                        pattern: '^https:\\/\\/',
+                                                                                        type: 'string',
+                                                                                    },
+                                                                                    volume: {
+                                                                                        maximum: 100,
+                                                                                        minimum: 0,
+                                                                                        type: 'integer',
+                                                                                    },
+                                                                                },
+                                                                                required: ['audio_url'],
+                                                                                type: 'object',
+                                                                            },
                                                                             play_chime: { type: 'boolean' },
+                                                                            play_favorite: {
+                                                                                properties: {
+                                                                                    favorite_id: {
+                                                                                        minLength: 1,
+                                                                                        type: 'string',
+                                                                                    },
+                                                                                    shuffle: { type: 'boolean' },
+                                                                                },
+                                                                                required: ['favorite_id'],
+                                                                                type: 'object',
+                                                                            },
                                                                             set_volume_to: {
                                                                                 maximum: 100,
                                                                                 minimum: 0,
@@ -65628,6 +66061,85 @@ const openapi = {
                 'x-title': 'Update a Space',
             },
         },
+        '/speakers/list_favorites': {
+            get: {
+                description: "Returns the favorites saved on a speaker's account in the speaker manufacturer's app, such as playlists, albums and radio stations. To play one, pass its `favorite_id` to `/speakers/play_favorite`. To check whether a speaker supports favorites, use `device.can_play_speaker_favorite`.",
+                operationId: 'speakersListFavoritesGet',
+                parameters: [
+                    {
+                        in: 'query',
+                        name: 'device_id',
+                        required: true,
+                        schema: {
+                            description: 'ID of the speaker for which you want to list favorites.',
+                            format: 'uuid',
+                            type: 'string',
+                        },
+                    },
+                ],
+                responses: {
+                    '200': {
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    properties: {
+                                        ok: { type: 'boolean' },
+                                        speaker_favorites: {
+                                            items: {
+                                                properties: {
+                                                    description: {
+                                                        description: 'Description of the favorite, such as its artist or station.',
+                                                        type: 'string',
+                                                    },
+                                                    favorite_id: {
+                                                        description: 'ID of the favorite. Pass it to `/speakers/play_favorite`.',
+                                                        type: 'string',
+                                                    },
+                                                    image_url: {
+                                                        description: "URL of the favorite's artwork.",
+                                                        type: 'string',
+                                                    },
+                                                    name: {
+                                                        description: 'Name of the favorite.',
+                                                        type: 'string',
+                                                    },
+                                                    service_name: {
+                                                        description: 'Name of the music service that provides the favorite.',
+                                                        type: 'string',
+                                                    },
+                                                },
+                                                required: ['favorite_id', 'name'],
+                                                type: 'object',
+                                            },
+                                            type: 'array',
+                                        },
+                                    },
+                                    required: ['speaker_favorites', 'ok'],
+                                    type: 'object',
+                                },
+                            },
+                        },
+                        description: 'OK',
+                    },
+                    '400': { description: 'Bad Request' },
+                    '401': { description: 'Unauthorized' },
+                },
+                security: [
+                    { client_session: [] },
+                    { pat_with_workspace: [] },
+                    { console_session_with_workspace: [] },
+                    { api_key: [] },
+                ],
+                summary: '/speakers/list_favorites',
+                tags: [],
+                'x-fern-sdk-group-name': ['speakers'],
+                'x-fern-sdk-method-name': 'list_favorites',
+                'x-fern-sdk-return-value': 'speaker_favorites',
+                'x-response-key': 'speaker_favorites',
+                'x-title': 'List Speaker Favorites',
+                'x-undocumented': 'Unreleased.',
+            },
+        },
         '/speakers/mute': {
             post: {
                 description: 'Mutes a specified speaker. To check whether a speaker supports muting, use `device.can_mute_speaker`.',
@@ -65746,6 +66258,76 @@ const openapi = {
                 'x-undocumented': 'Unreleased.',
             },
         },
+        '/speakers/play_audio_clip': {
+            post: {
+                description: 'Plays a short audio clip from a URL on a speaker, over whatever the speaker is playing. Use it for a welcome message or announcement. To check whether a speaker supports audio clips, use `device.can_play_speaker_audio_clip`.',
+                operationId: 'speakersPlayAudioClipPost',
+                requestBody: {
+                    content: {
+                        'application/json': {
+                            schema: {
+                                properties: {
+                                    audio_url: {
+                                        description: 'Public HTTPS URL of the MP3 or WAV file to play. The speaker downloads the file itself, so it must be reachable from the internet.',
+                                        format: 'uri',
+                                        maxLength: 2048,
+                                        type: 'string',
+                                    },
+                                    device_id: {
+                                        description: 'ID of the speaker on which you want to play the audio clip.',
+                                        format: 'uuid',
+                                        type: 'string',
+                                    },
+                                    volume: {
+                                        description: "Volume at which to play the clip, on the speaker's native volume scale. If you omit this parameter, the clip plays at the speaker's current volume.",
+                                        format: 'float',
+                                        type: 'number',
+                                    },
+                                },
+                                required: ['device_id', 'audio_url'],
+                                type: 'object',
+                            },
+                        },
+                    },
+                },
+                responses: {
+                    '200': {
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    properties: {
+                                        action_attempt: {
+                                            $ref: '#/components/schemas/action_attempt',
+                                        },
+                                        ok: { type: 'boolean' },
+                                    },
+                                    required: ['action_attempt', 'ok'],
+                                    type: 'object',
+                                },
+                            },
+                        },
+                        description: 'OK',
+                    },
+                    '400': { description: 'Bad Request' },
+                    '401': { description: 'Unauthorized' },
+                },
+                security: [
+                    { client_session: [] },
+                    { pat_with_workspace: [] },
+                    { console_session_with_workspace: [] },
+                    { api_key: [] },
+                ],
+                summary: '/speakers/play_audio_clip',
+                tags: [],
+                'x-action-attempt-type': 'PLAY_SPEAKER_AUDIO_CLIP',
+                'x-fern-sdk-group-name': ['speakers'],
+                'x-fern-sdk-method-name': 'play_audio_clip',
+                'x-fern-sdk-return-value': 'action_attempt',
+                'x-response-key': 'action_attempt',
+                'x-title': 'Play an Audio Clip on a Speaker',
+                'x-undocumented': 'Unreleased.',
+            },
+        },
         '/speakers/play_chime': {
             post: {
                 description: 'Plays a short chime on a specified speaker. To check whether a speaker supports playing a chime, use `device.can_play_speaker_chime`.',
@@ -65810,6 +66392,74 @@ const openapi = {
                 'x-undocumented': 'Unreleased.',
             },
         },
+        '/speakers/play_favorite': {
+            post: {
+                description: 'Replaces what a speaker is playing with one of its favorites and starts playback. Speakers grouped with the requested speaker play it too. To check whether a speaker supports favorites, use `device.can_play_speaker_favorite`.',
+                operationId: 'speakersPlayFavoritePost',
+                requestBody: {
+                    content: {
+                        'application/json': {
+                            schema: {
+                                properties: {
+                                    device_id: {
+                                        description: 'ID of the speaker on which you want to play the favorite.',
+                                        format: 'uuid',
+                                        type: 'string',
+                                    },
+                                    favorite_id: {
+                                        description: 'ID of the favorite that you want to play, from `/speakers/list_favorites`.',
+                                        minLength: 1,
+                                        type: 'string',
+                                    },
+                                    shuffle: {
+                                        description: "Whether to shuffle the favorite's tracks. If you omit this parameter, the speaker keeps its current shuffle setting.",
+                                        type: 'boolean',
+                                    },
+                                },
+                                required: ['device_id', 'favorite_id'],
+                                type: 'object',
+                            },
+                        },
+                    },
+                },
+                responses: {
+                    '200': {
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    properties: {
+                                        action_attempt: {
+                                            $ref: '#/components/schemas/action_attempt',
+                                        },
+                                        ok: { type: 'boolean' },
+                                    },
+                                    required: ['action_attempt', 'ok'],
+                                    type: 'object',
+                                },
+                            },
+                        },
+                        description: 'OK',
+                    },
+                    '400': { description: 'Bad Request' },
+                    '401': { description: 'Unauthorized' },
+                },
+                security: [
+                    { client_session: [] },
+                    { pat_with_workspace: [] },
+                    { console_session_with_workspace: [] },
+                    { api_key: [] },
+                ],
+                summary: '/speakers/play_favorite',
+                tags: [],
+                'x-action-attempt-type': 'PLAY_SPEAKER_FAVORITE',
+                'x-fern-sdk-group-name': ['speakers'],
+                'x-fern-sdk-method-name': 'play_favorite',
+                'x-fern-sdk-return-value': 'action_attempt',
+                'x-response-key': 'action_attempt',
+                'x-title': 'Play a Favorite on a Speaker',
+                'x-undocumented': 'Unreleased.',
+            },
+        },
         '/speakers/resume': {
             post: {
                 description: 'Resumes playback on a specified speaker. Playback also resumes on the speakers grouped with it, and the action attempt result lists every affected speaker. To check whether a speaker supports resuming playback, use `device.can_resume_speaker_playback`.',