{"openapi":"3.0.3","info":{"title":"Recall.ai API","version":"0.0.0","description":"Recall.ai API Documentation"},"paths":{"/api/internal/ask-ai/inkeep-auth-token/":{"post":{"operationId":"api_internal_ask_ai_inkeep_auth_token_create","tags":["api"],"security":[{"tokenAuth":[]}],"responses":{"200":{"description":"No response body"}}}},"/api/internal/ask-ai/mcp-tools/":{"get":{"operationId":"api_internal_ask_ai_mcp_tools_retrieve","tags":["api"],"security":[{"tokenAuth":[]}],"responses":{"200":{"description":"No response body"}}}},"/api/internal/ask-ai/mcp-tools/call/":{"post":{"operationId":"api_internal_ask_ai_mcp_tools_call_create","tags":["api"],"security":[{"tokenAuth":[]}],"responses":{"200":{"description":"No response body"}}}},"/api/v1/audio_mixed/":{"get":{"operationId":"audio_mixed_list","summary":"List Audio Mixed","parameters":[{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"recording_id","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"status_code","schema":{"type":"string","enum":["done","failed","processing"]},"description":"* `processing` - Processing\n* `done` - Done\n* `failed` - Failed"}],"tags":["audio_mixed"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedAudioMixedArtifactList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 60 requests per min per workspace"}},"/api/v1/audio_mixed/{id}/":{"get":{"operationId":"audio_mixed_retrieve","summary":"Retrieve Audio Mixed","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this audio mixed artifact.","required":true}],"tags":["audio_mixed"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudioMixedArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"patch":{"operationId":"audio_mixed_partial_update","summary":"Update Audio Mixed","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this audio mixed artifact.","required":true}],"tags":["audio_mixed"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedAudioMixedArtifactRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedAudioMixedArtifactRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedAudioMixedArtifactRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudioMixedArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"delete":{"operationId":"audio_mixed_destroy","summary":"Delete Audio Mixed","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this audio mixed artifact.","required":true}],"tags":["audio_mixed"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"}},"/api/v1/audio_separate/":{"get":{"operationId":"audio_separate_list","summary":"List Audio Separate","parameters":[{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"recording_id","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"status_code","schema":{"type":"string","enum":["done","failed","processing"]},"description":"* `processing` - Processing\n* `done` - Done\n* `failed` - Failed"}],"tags":["audio_separate"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedAudioSeparateArtifactList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 60 requests per min per workspace"}},"/api/v1/audio_separate/{id}/":{"get":{"operationId":"audio_separate_retrieve","summary":"Retrieve Audio Separate","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this audio separate artifact.","required":true}],"tags":["audio_separate"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudioSeparateArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"patch":{"operationId":"audio_separate_partial_update","summary":"Update Audio Separate","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this audio separate artifact.","required":true}],"tags":["audio_separate"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedAudioSeparateArtifactRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedAudioSeparateArtifactRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedAudioSeparateArtifactRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudioSeparateArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"delete":{"operationId":"audio_separate_destroy","summary":"Delete Audio Separate","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this audio separate artifact.","required":true}],"tags":["audio_separate"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"}},"/api/v1/billing/usage/":{"get":{"operationId":"billing_usage_retrieve","description":"Get bot usage statistics\n\nThe base rate limit for this endpoint is:\n- 5 requests per min per workspace","summary":"Get Usage","parameters":[{"in":"query","name":"end","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"start","schema":{"type":"string","format":"date-time"}}],"tags":["billing"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":5,"period":"min"}]}},"/api/v1/bot/":{"get":{"operationId":"bot_list","description":"Get a list of all bots\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Bots","parameters":[{"in":"query","name":"join_at_after","schema":{"type":"string","format":"date"}},{"in":"query","name":"join_at_before","schema":{"type":"string","format":"date"}},{"in":"query","name":"meeting_url","schema":{"type":"string"}},{"in":"query","name":"metadata__<key>","schema":{"type":"string"},"description":"Filter by metadata. Replace <key> with the metadata key you want to filter on."},{"name":"page","required":false,"in":"query","description":"A page number within the paginated result set.","schema":{"type":"integer"}},{"in":"query","name":"platform","schema":{"type":"array","items":{"type":"string","enum":["chime_sdk","google_meet","google_meet_media_api","goto_meeting","microsoft_teams","microsoft_teams_live","slack_authenticator","slack_huddle_observer","webex","zoom","zoom_rtms"]}},"description":"* `zoom` - Zoom\n* `google_meet` - Meet\n* `goto_meeting` - Goto\n* `microsoft_teams` - Teams\n* `microsoft_teams_live` - Teams Live\n* `webex` - Webex\n* `chime_sdk` - Chime Sdk\n* `zoom_rtms` - Zoom Rtms\n* `google_meet_media_api` - Google Meet Media Api\n* `slack_authenticator` - Slack Authenticator\n* `slack_huddle_observer` - Slack Huddle Observer","explode":true,"style":"form"},{"in":"query","name":"status","schema":{"type":"array","items":{"type":"string","enum":["analysis_done","analysis_failed","call_ended","done","fatal","in_call_not_recording","in_call_recording","in_waiting_room","joining_call","media_expired","ready","recording_done","recording_permission_allowed","recording_permission_denied"]}},"description":"* `ready` - Ready\n* `joining_call` - Joining Call\n* `in_waiting_room` - In Waiting Room\n* `in_call_not_recording` - In Call Not Recording\n* `recording_permission_allowed` - Recording Permission Allowed\n* `recording_permission_denied` - Recording Permission Denied\n* `in_call_recording` - In Call Recording\n* `recording_done` - Recording Done\n* `call_ended` - Call Ended\n* `done` - Done\n* `fatal` - Fatal\n* `media_expired` - Media Expired\n* `analysis_done` - Analysis Done\n* `analysis_failed` - Analysis Failed","explode":true,"style":"form"},{"in":"query","name":"use_cursor","schema":{"type":"string"},"description":"When present, uses cursor-based pagination instead of offset pagination."}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedBotList"}}},"description":""},"400":{"description":"No response body"},"404":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]},"post":{"operationId":"bot_create","description":"Create a new bot.\n\nThe base rate limit for this endpoint is:\n- 120 requests per min per workspace","summary":"Create Bot","tags":["bot"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/BotRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/BotRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""},"400":{"description":"No response body"},"507":{"content":{"application/json":{"schema":{"description":"If no bots are available in the ad-hoc bot pool the HTTP 507 code is returned. The ad-hoc bot pool is replenished every few minutes so retrying the request will eventually succeed."}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":120,"period":"min"}]}},"/api/v1/bot/{bot_id}/screenshots/":{"get":{"operationId":"bot_screenshots_list","description":"Get a list of all screenshots of the bot\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Bot Screenshots","parameters":[{"in":"query","name":"action","schema":{"type":"string"},"description":"Navigation direction ('prev' for previous page)"},{"in":"query","name":"continuation_token","schema":{"type":"string"},"description":"Token for fetching the next page of results"},{"in":"query","name":"meta","schema":{"type":"string"},"description":"Encoded metadata for pagination state"},{"in":"path","name":"bot_id","schema":{"type":"string","format":"uuid"},"description":"The ID of the bot for which to retrieve the screenshots","required":true},{"in":"query","name":"recorded_at_after","schema":{"type":"string","format":"date-time"},"description":"Filter screenshots recorded after this datetime"},{"in":"query","name":"recorded_at_before","schema":{"type":"string","format":"date-time"},"description":"Filter screenshots recorded before this datetime"}],"tags":["bot-screenshots"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BotScreenshot"}}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]}},"/api/v1/bot/{bot_id}/screenshots/{id}/":{"get":{"operationId":"bot_screenshots_retrieve","description":"Get a bot screenshot instance.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Retrieve Bot Screenshot","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot screenshot.","required":true},{"in":"path","name":"bot_id","schema":{"type":"string","format":"uuid"},"description":"The ID of the bot for which to retrieve the screenshot","required":true}],"tags":["bot-screenshots"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotScreenshot"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/":{"get":{"operationId":"bot_retrieve","description":"Get a bot instance.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Retrieve Bot","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"patch":{"operationId":"bot_partial_update","description":"Update a Scheduled Bot.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Update Scheduled Bot","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedBotRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedBotRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedBotRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"delete":{"operationId":"bot_destroy","description":"Deletes a bot. This can only be done on scheduled bots that have not yet joined a call.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Delete Scheduled Bot","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"},"405":{"content":{"application/json":{"schema":{"description":"The specified Bot cannot be deleted. Only scheduled bots which have not yet joined a call can be deleted."}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/delete_media/":{"post":{"operationId":"bot_delete_media_create","description":"Deletes bot media stored by Recall. This is irreversible.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Delete Bot Media","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""},"400":{"content":{"application/json":{"schema":{"description":"Cannot delete media for an in-progress bot."}}},"description":""},"409":{"content":{"application/json":{"schema":{"description":"A request to delete media for this bot is already in progress."}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/leave_call/":{"post":{"operationId":"bot_leave_call_create","description":"Removes the bot from the meeting. This is irreversible.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Remove Bot From Call","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""},"400":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/output_audio/":{"post":{"operationId":"bot_output_audio_create","description":"Causes the bot to output audio. \nNote: The bot must be configured with 'automatic_audio_output' enabled in order to use this endpoint.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Output Audio","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudioOutputDataRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/AudioOutputDataRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/AudioOutputDataRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"delete":{"operationId":"bot_output_audio_destroy","description":"Causes the bot to output audio. \nNote: The bot must be configured with 'automatic_audio_output' enabled in order to use this endpoint.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Output Audio","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/output_media/":{"post":{"operationId":"bot_output_media_create","description":"Causes the bot to start outputting media.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Output Media","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutputMediaRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/OutputMediaRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/OutputMediaRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"delete":{"operationId":"bot_output_media_destroy","description":"Causes the bot to start outputting media.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Output Media","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"camera":{"type":"boolean","description":"Stop outputting media on the bot camera","default":false},"screenshare":{"type":"boolean","description":"Stop outputting media on the bot screenshare","default":false}},"additionalProperties":false}}},"required":true}}},"/api/v1/bot/{id}/output_screenshare/":{"post":{"operationId":"bot_output_screenshare_create","description":"Causes the bot to start screensharing.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Start Screenshare","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoOutputRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/VideoOutputRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/VideoOutputRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"delete":{"operationId":"bot_output_screenshare_destroy","description":"Causes the bot to start screensharing.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Start Screenshare","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/output_video/":{"post":{"operationId":"bot_output_video_create","description":"Causes the bot to start outputting video.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Output Video","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoOutputRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/VideoOutputRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/VideoOutputRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"delete":{"operationId":"bot_output_video_destroy","description":"Causes the bot to stop outputting video.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Stop Output Video","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/pause_recording/":{"post":{"operationId":"bot_pause_recording_create","description":"Instructs the bot to pause the current recording.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Pause Recording","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""},"400":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/pin_participant/":{"post":{"operationId":"bot_pin_participant_create","description":"Pin or unpin a participant's video.\nNote: This is only applicable for 'video_separate_h264' streams\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Pin Participant","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinParticipantRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PinParticipantRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PinParticipantRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""},"400":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/request_recording_permission/":{"post":{"operationId":"bot_request_recording_permission_create","description":"Zoom Only: Request recording permission from the host.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Request Recording Permission","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""},"400":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/resume_recording/":{"post":{"operationId":"bot_resume_recording_create","description":"Instructs the bot to resume a paused recording.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Resume Recording","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""},"400":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/send_chat_message/":{"post":{"operationId":"bot_send_chat_message_create","description":"Causes the bot to send a message in the meeting chat. \n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Send Chat Message","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendChatMessageInputRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/SendChatMessageInputRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/SendChatMessageInputRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""},"400":{"description":"No response body"},"404":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/start_recording/":{"post":{"operationId":"bot_start_recording_create","description":"Instructs the bot to start recording the meeting. This will restart the current recording if one is already in progress.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Start Recording","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotRecordingConfigRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/BotRecordingConfigRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/BotRecordingConfigRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""},"400":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/bot/{id}/stop_recording/":{"post":{"operationId":"bot_stop_recording_create","description":"Instructs the bot to end the current recording.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Stop Recording","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this bot.","required":true}],"tags":["bot"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}},"description":""},"400":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/calendar/authenticate/":{"post":{"operationId":"calendar_authenticate_create","description":"Generate an authentication token for calendar APIs, scoped to the user. Each token has an expiry of 1 day from time of creation.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Get Calendar Auth Token","tags":["calendar-v1"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarAuthenticateRequestRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CalendarAuthenticateRequestRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CalendarAuthenticateRequestRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarAuthenticateResponse"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/calendar/meetings/":{"get":{"operationId":"calendar_meetings_list","description":"List all calendar meetings for the calendar user.\n\nThe base rate limit for this endpoint is:\n- 120 requests per min per calendar_user","summary":"List Calendar Meetings","parameters":[{"in":"query","name":"ical_uid","schema":{"type":"string"},"description":"Filter results by ical_uid. (Case sensitive prefix match will be performed.)"},{"in":"query","name":"start_time_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"start_time_before","schema":{"type":"string","format":"date-time"}}],"tags":["calendar-v1"],"security":[{"CalendarJwtAuthentication":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CalendarMeeting"}}}},"description":""}},"x-throttles":[{"scope_key":"calendar_user_id","limit":120,"period":"min"}]}},"/api/v1/calendar/meetings/{id}/":{"get":{"operationId":"calendar_meetings_retrieve","summary":"Retrieve Calendar Meeting","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this calendar meeting.","required":true}],"tags":["calendar-v1"],"security":[{"CalendarJwtAuthentication":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarMeeting"}}},"description":""}},"x-throttles":[{"scope_key":"calendar_user_id","limit":120,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 120 requests per min per calendar_user"},"put":{"operationId":"calendar_meetings_update","description":"Use this endpoint to update override_should_record property of the meeting.\n\nThe base rate limit for this endpoint is:\n- 120 requests per min per calendar_user","summary":"Update Calendar Meeting","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this calendar meeting.","required":true}],"tags":["calendar-v1"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarMeetingRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CalendarMeetingRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CalendarMeetingRequest"}}}},"security":[{"CalendarJwtAuthentication":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarMeeting"}}},"description":""}},"x-throttles":[{"scope_key":"calendar_user_id","limit":120,"period":"min"}]}},"/api/v1/calendar/meetings/refresh/":{"post":{"operationId":"calendar_meetings_refresh_create","description":"Resync the calendar meetings for the user.\n\nThe base rate limit for this endpoint is:\n- 120 requests per min per calendar_user","summary":"Refresh Calendar Meetings","tags":["calendar-v1"],"security":[{"CalendarJwtAuthentication":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CalendarMeeting"}}}},"description":""}},"x-throttles":[{"scope_key":"calendar_user_id","limit":120,"period":"min"}]}},"/api/v1/calendar/user/":{"get":{"operationId":"calendar_user_retrieve","summary":"Get Calendar User","tags":["calendar-v1"],"security":[{"CalendarJwtAuthentication":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarUser"}}},"description":""}},"x-throttles":[{"scope_key":"calendar_user_id","limit":120,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 120 requests per min per calendar_user"},"put":{"operationId":"calendar_user_update","description":"Update the recording preferences for a calendar user.\n\nThe base rate limit for this endpoint is:\n- 120 requests per min per calendar_user","summary":"Update Recording Preferences","tags":["calendar-v1"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarUserRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CalendarUserRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CalendarUserRequest"}}}},"security":[{"CalendarJwtAuthentication":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarUser"}}},"description":""}},"x-throttles":[{"scope_key":"calendar_user_id","limit":120,"period":"min"}]},"delete":{"operationId":"calendar_user_destroy","description":"Delete calendar user(+disconnect any connected calendars).\n\nThe base rate limit for this endpoint is:\n- 120 requests per min per calendar_user","summary":"Delete Calendar User","tags":["calendar-v1"],"security":[{"CalendarJwtAuthentication":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"calendar_user_id","limit":120,"period":"min"}]}},"/api/v1/calendar/user/disconnect/":{"post":{"operationId":"calendar_user_disconnect_create","description":"Disconnect calendar of specific platform.\n\nThe base rate limit for this endpoint is:\n- 120 requests per min per calendar_user","summary":"Disconnect Calendar Platform","tags":["calendar-v1"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarUserDisconnectPlatformRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CalendarUserDisconnectPlatformRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CalendarUserDisconnectPlatformRequest"}}},"required":true},"security":[{"CalendarJwtAuthentication":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarUser"}}},"description":""}},"x-throttles":[{"scope_key":"calendar_user_id","limit":120,"period":"min"}]}},"/api/v1/calendar/users/":{"get":{"operationId":"calendar_users_list","description":"List all calendar users created for the account.\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Calendar Users","parameters":[{"in":"query","name":"email","schema":{"type":"string"},"description":"Filter results by email address"},{"in":"query","name":"paginate","schema":{"type":"boolean","default":false},"description":"Enable pagination for the results"}],"tags":["calendar-v1"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CalendarUser"}}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]}},"/api/v1/meeting_direct_connect/":{"get":{"operationId":"meeting_direct_connect_list","description":"Get a list of all Meeting Direct Connect\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Meeting Direct Connects","tags":["meeting-direct-connect"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MeetingDirectConnect"}}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]},"post":{"operationId":"meeting_direct_connect_create","description":"Create a new Meeting Direct Connect\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"Create Meeting Direct Connect","tags":["meeting-direct-connect"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingDirectConnectRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/MeetingDirectConnectRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/MeetingDirectConnectRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingDirectConnect"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]}},"/api/v1/meeting_direct_connect/{id}/":{"get":{"operationId":"meeting_direct_connect_retrieve","description":"Get a Meeting Direct Connect instance\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Retrieve Meeting Direct Connect","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this meeting direct connect.","required":true}],"tags":["meeting-direct-connect"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingDirectConnect"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/meeting_metadata/":{"get":{"operationId":"meeting_metadata_list","summary":"List Meeting Metadata","parameters":[{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"recording_id","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"status_code","schema":{"type":"string","enum":["done","failed","processing"]},"description":"* `processing` - Processing\n* `done` - Done\n* `failed` - Failed"}],"tags":["meeting_metadata"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedMeetingMetadataArtifactList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 60 requests per min per workspace"}},"/api/v1/meeting_metadata/{id}/":{"get":{"operationId":"meeting_metadata_retrieve","summary":"Retrieve Meeting Metadata","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this meeting metadata artifact.","required":true}],"tags":["meeting_metadata"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingMetadataArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"patch":{"operationId":"meeting_metadata_partial_update","summary":"Update Meeting Metadata","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this meeting metadata artifact.","required":true}],"tags":["meeting_metadata"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedMeetingMetadataArtifactRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedMeetingMetadataArtifactRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedMeetingMetadataArtifactRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingMetadataArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"delete":{"operationId":"meeting_metadata_destroy","summary":"Delete Meeting Metadata","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this meeting metadata artifact.","required":true}],"tags":["meeting_metadata"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"}},"/api/v1/participant_events/":{"get":{"operationId":"participant_events_list","summary":"List Participant Events","parameters":[{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"recording_id","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"status_code","schema":{"type":"string","enum":["done","failed","processing"]},"description":"* `processing` - Processing\n* `done` - Done\n* `failed` - Failed"}],"tags":["participant_events"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedParticipantEventsArtifactList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 60 requests per min per workspace"}},"/api/v1/participant_events/{id}/":{"get":{"operationId":"participant_events_retrieve","summary":"Retrieve Participant Events","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this participant events artifact.","required":true}],"tags":["participant_events"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParticipantEventsArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"patch":{"operationId":"participant_events_partial_update","summary":"Update Participant Events","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this participant events artifact.","required":true}],"tags":["participant_events"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedParticipantEventsArtifactRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedParticipantEventsArtifactRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedParticipantEventsArtifactRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParticipantEventsArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"delete":{"operationId":"participant_events_destroy","summary":"Delete Participant Events","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this participant events artifact.","required":true}],"tags":["participant_events"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"}},"/api/v1/realtime_endpoint/":{"get":{"operationId":"realtime_endpoint_list","summary":"List Realtime Endpoints","parameters":[{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"recording_id","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"status_code","schema":{"type":"string","enum":["done","failed","running"]},"description":"* `running` - Running\n* `done` - Done\n* `failed` - Failed"},{"in":"query","name":"type","schema":{"type":"string","enum":["desktop_sdk_callback","rtmp","webhook","websocket"]},"description":"* `rtmp` - Rtmp\n* `websocket` - Websocket\n* `webhook` - Webhook\n* `desktop_sdk_callback` - Desktop Sdk Callback"}],"tags":["realtime_endpoint"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedRealtimeEndpointList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 60 requests per min per workspace"}},"/api/v1/realtime_endpoint/{id}/":{"get":{"operationId":"realtime_endpoint_retrieve","summary":"Retrieve Realtime Endpoints","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this realtime endpoint.","required":true}],"tags":["realtime_endpoint"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealtimeEndpoint"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"patch":{"operationId":"realtime_endpoint_partial_update","summary":"Update Realtime Endpoints","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this realtime endpoint.","required":true}],"tags":["realtime_endpoint"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedRealtimeEndpointRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedRealtimeEndpointRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedRealtimeEndpointRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealtimeEndpoint"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"}},"/api/v1/recording/":{"get":{"operationId":"recording_list","summary":"List Recordings","parameters":[{"in":"query","name":"bot_id","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"desktop_sdk_upload_id","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"status_code","schema":{"type":"string","nullable":true,"enum":["done","failed","paused","processing"]},"description":"* `processing` - Processing\n* `paused` - Paused\n* `done` - Done\n* `failed` - Failed"}],"tags":["recording"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedRecordingList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 60 requests per min per workspace"}},"/api/v1/recording/{id}/":{"get":{"operationId":"recording_retrieve","summary":"Retrieve Recording","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this recording.","required":true}],"tags":["recording"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Recording"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"patch":{"operationId":"recording_partial_update","summary":"Update Recording","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this recording.","required":true}],"tags":["recording"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedRecordingRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedRecordingRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedRecordingRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Recording"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"delete":{"operationId":"recording_destroy","summary":"Delete Recording","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this recording.","required":true}],"tags":["recording"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"}},"/api/v1/recording/{id}/create_transcript/":{"post":{"operationId":"recording_create_transcript_create","summary":"Create Async Transcript","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this recording.","required":true}],"tags":["recording"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordingCreateTranscriptArtifactRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/RecordingCreateTranscriptArtifactRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/RecordingCreateTranscriptArtifactRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"bot_id","limit":5,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 5 requests per min per bot"}},"/api/v1/sdk_upload/":{"get":{"operationId":"sdk_upload_list","description":"Get a list of all Desktop SDK uploads\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Desktop SDK Uploads","parameters":[{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}}],"tags":["sdk_upload"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedDesktopSdkUploadList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]},"post":{"operationId":"sdk_upload_create","description":"Create a new Desktop SDK upload.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Create Desktop SDK Upload","tags":["sdk_upload"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopSdkUploadRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/DesktopSdkUploadRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/DesktopSdkUploadRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopSdkUpload"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/sdk_upload/{id}/":{"get":{"operationId":"sdk_upload_retrieve","description":"Get a Desktop SDK upload instance.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Retrieve Desktop SDK Upload","parameters":[{"in":"path","name":"id","schema":{"type":"string"},"required":true}],"tags":["sdk_upload"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopSdkUpload"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v1/transcript/":{"get":{"operationId":"transcript_list","summary":"List Transcript","parameters":[{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"recording_id","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"status_code","schema":{"type":"string","enum":["done","failed","processing"]},"description":"* `processing` - Processing\n* `done` - Done\n* `failed` - Failed"}],"tags":["transcript"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedTranscriptArtifactList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 60 requests per min per workspace"}},"/api/v1/transcript/{id}/":{"get":{"operationId":"transcript_retrieve","summary":"Retrieve Transcript","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this transcript artifact.","required":true}],"tags":["transcript"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"patch":{"operationId":"transcript_partial_update","summary":"Update Transcript","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this transcript artifact.","required":true}],"tags":["transcript"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedTranscriptArtifactRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedTranscriptArtifactRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedTranscriptArtifactRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"delete":{"operationId":"transcript_destroy","summary":"Delete Transcript","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this transcript artifact.","required":true}],"tags":["transcript"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"}},"/api/v1/video_mixed/":{"get":{"operationId":"video_mixed_list","summary":"List Video Mixed","parameters":[{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"recording_id","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"status_code","schema":{"type":"string","enum":["done","failed","processing"]},"description":"* `processing` - Processing\n* `done` - Done\n* `failed` - Failed"}],"tags":["video_mixed"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedVideoMixedArtifactList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 60 requests per min per workspace"}},"/api/v1/video_mixed/{id}/":{"get":{"operationId":"video_mixed_retrieve","summary":"Retrieve Video Mixed","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this video mixed artifact.","required":true}],"tags":["video_mixed"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoMixedArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"patch":{"operationId":"video_mixed_partial_update","summary":"Update Video Mixed","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this video mixed artifact.","required":true}],"tags":["video_mixed"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedVideoMixedArtifactRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedVideoMixedArtifactRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedVideoMixedArtifactRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoMixedArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"delete":{"operationId":"video_mixed_destroy","summary":"Delete Video Mixed","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this video mixed artifact.","required":true}],"tags":["video_mixed"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"}},"/api/v1/video_separate/":{"get":{"operationId":"video_separate_list","summary":"List Video Separate","parameters":[{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"recording_id","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"status_code","schema":{"type":"string","enum":["done","failed","processing"]},"description":"* `processing` - Processing\n* `done` - Done\n* `failed` - Failed"}],"tags":["video_separate"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedVideoSeparateArtifactList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 60 requests per min per workspace"}},"/api/v1/video_separate/{id}/":{"get":{"operationId":"video_separate_retrieve","summary":"Retrieve Video Separate","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this video separate artifact.","required":true}],"tags":["video_separate"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoSeparateArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"patch":{"operationId":"video_separate_partial_update","summary":"Update Video Separate","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this video separate artifact.","required":true}],"tags":["video_separate"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedVideoSeparateArtifactRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedVideoSeparateArtifactRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedVideoSeparateArtifactRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoSeparateArtifact"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"delete":{"operationId":"video_separate_destroy","summary":"Delete Video Separate","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this video separate artifact.","required":true}],"tags":["video_separate"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"}},"/api/v2/calendar-events/":{"get":{"operationId":"calendar_events_list","description":"Get a list of calendar events.\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Calendar Events","parameters":[{"in":"query","name":"calendar_id","schema":{"type":"string","format":"uuid"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"ical_uid","schema":{"type":"string"},"description":"Filter results by ical_uid. (Case sensitive prefix match will be performed.)"},{"in":"query","name":"is_deleted","schema":{"type":"boolean"}},{"in":"query","name":"start_time","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"start_time__gte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"start_time__lte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"updated_at__gte","schema":{"type":"string","format":"date-time"}}],"tags":["calendar-v2"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCalendarEventList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]}},"/api/v2/calendar-events/{id}/":{"get":{"operationId":"calendar_events_retrieve","description":"Get a calendar event instance.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Retrieve Calendar Event","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this calendar event.","required":true}],"tags":["calendar-v2"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarEvent"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/calendar-events/{id}/bot/":{"post":{"operationId":"calendar_events_bot_create","description":"Schedule a bot for a calendar event. This endpoint will return the updated calendar event in response.\n\nThe base rate limit for this endpoint is:\n- 600 requests per min per workspace","summary":"Schedule Bot For Calendar Event","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this calendar event.","required":true}],"tags":["calendar-v2"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarEventAddBotRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CalendarEventAddBotRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CalendarEventAddBotRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarEvent"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":600,"period":"min"}]},"delete":{"operationId":"calendar_events_bot_destroy","description":"Schedule a bot for a calendar event. This endpoint will return the updated calendar event in response.\n\nThe base rate limit for this endpoint is:\n- 600 requests per min per workspace","summary":"Schedule Bot For Calendar Event","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this calendar event.","required":true}],"tags":["calendar-v2"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarEvent"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":600,"period":"min"}]}},"/api/v2/calendars/":{"get":{"operationId":"calendars_list","description":"Get a list of calendars.\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Calendars","parameters":[{"in":"query","name":"created_at__gte","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"email","schema":{"type":"string"}},{"in":"query","name":"platform","schema":{"type":"string","enum":["google_calendar","microsoft_outlook"]},"description":"* `google_calendar` - Google Calendar\n* `microsoft_outlook` - Microsoft Outlook"},{"in":"query","name":"status","schema":{"type":"string","enum":["connected","connecting","disconnected"]},"description":"* `connecting` - Connecting\n* `connected` - Connected\n* `disconnected` - Disconnected"}],"tags":["calendar-v2"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCalendarList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]},"post":{"operationId":"calendars_create","description":"Create a new calendar.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Create Calendar","tags":["calendar-v2"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CalendarRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CalendarRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Calendar"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/calendars/{id}/":{"get":{"operationId":"calendars_retrieve","description":"Get a calendar instance.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Retrieve Calendar","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this calendar.","required":true}],"tags":["calendar-v2"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Calendar"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"patch":{"operationId":"calendars_partial_update","description":"Update an existing calendar.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Update Calendar","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this calendar.","required":true}],"tags":["calendar-v2"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedCalendarRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedCalendarRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedCalendarRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Calendar"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"delete":{"operationId":"calendars_destroy","description":"Deletes a calendar. This will disconnect the calendar.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Delete Calendar","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this calendar.","required":true}],"tags":["calendar-v2"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/calendars/{id}/access-token/":{"post":{"operationId":"calendars_access_token_create","description":"Get the OAuth access token for this calendar account.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Get Access Token","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this calendar.","required":true}],"tags":["calendar-v2"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarAccessToken"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarAccountAccessTokenError"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/google-login-groups/":{"get":{"operationId":"google_login_groups_list","description":"Get list of all Google Login Groups.\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Google Login Groups","parameters":[{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"name","schema":{"type":"string"}},{"in":"query","name":"name__contains","schema":{"type":"string"}},{"name":"ordering","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}}],"tags":["google-login-group"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedGoogleLoginGroupList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]},"post":{"operationId":"google_login_groups_create","description":"Create a new Google Login Group.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Create Google Login Group","tags":["google-login-group"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLoginGroupRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/GoogleLoginGroupRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/GoogleLoginGroupRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLoginGroup"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/google-login-groups/{id}/":{"get":{"operationId":"google_login_groups_retrieve","description":"Get an existing Google Login Group.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Retrieve Google Login Group","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this google login group.","required":true}],"tags":["google-login-group"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLoginGroup"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"put":{"operationId":"google_login_groups_update","description":"Update an existing Google Login Group.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Update Google Login Group","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this google login group.","required":true}],"tags":["google-login-group"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLoginGroupRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/GoogleLoginGroupRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/GoogleLoginGroupRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLoginGroup"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"patch":{"operationId":"google_login_groups_partial_update","description":"Partial Update an existing Google Login Group.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Partial Update Google Login Group","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this google login group.","required":true}],"tags":["google-login-group"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedGoogleLoginGroupRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedGoogleLoginGroupRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedGoogleLoginGroupRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLoginGroup"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"delete":{"operationId":"google_login_groups_destroy","description":"Deletes an existing Google Login Group.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Destroy Google Login Group","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this google login group.","required":true}],"tags":["google-login-group"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/google-logins/":{"get":{"operationId":"google_logins_list","description":"Get list of all Google Logins.\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Google Logins","parameters":[{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"email","schema":{"type":"string"}},{"in":"query","name":"group_id","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"is_active","schema":{"type":"boolean"}},{"name":"ordering","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}},{"in":"query","name":"sso_v2_workspace_domain","schema":{"type":"string"}}],"tags":["google-login"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedGoogleLoginList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]},"post":{"operationId":"google_logins_create","description":"Create a new Google Login.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Create Google Login","tags":["google-login"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLoginRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/GoogleLoginRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/GoogleLoginRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLogin"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/google-logins/{id}/":{"get":{"operationId":"google_logins_retrieve","description":"Get an existing Google Login.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Retrieve Google Login","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this google login.","required":true}],"tags":["google-login"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLogin"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"put":{"operationId":"google_logins_update","description":"Update an existing Google Login.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Update Google Login","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this google login.","required":true}],"tags":["google-login"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLoginRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/GoogleLoginRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/GoogleLoginRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLogin"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"patch":{"operationId":"google_logins_partial_update","description":"Partial Update an existing Google Login.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Partial Update Google Login","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this google login.","required":true}],"tags":["google-login"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedGoogleLoginRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedGoogleLoginRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedGoogleLoginRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLogin"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"delete":{"operationId":"google_logins_destroy","description":"Deletes an existing Google Login.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Destroy Google Login","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this google login.","required":true}],"tags":["google-login"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/slack-teams/":{"get":{"operationId":"slack_teams_list","description":"List all Slack Team Integrations\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Slack Teams","tags":["slack-teams"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SlackTeamIntegration"}}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]},"post":{"operationId":"slack_teams_create","summary":"Create Slack Team","tags":["slack-teams"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackTeamIntegrationRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/SlackTeamIntegrationRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/SlackTeamIntegrationRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackTeamIntegration"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"}},"/api/v2/slack-teams/{slack_team_integration_id}/oauth-tokens/":{"get":{"operationId":"slack_teams_oauth_tokens_list","description":"List all Slack user OAuth tokens for the specified team integration\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Slack User OAuth Tokens","parameters":[{"in":"path","name":"slack_team_integration_id","schema":{"type":"string"},"required":true}],"tags":["slack-teams"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SlackUserOauthToken"}}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]},"post":{"operationId":"slack_teams_oauth_tokens_create","description":"Create a new Slack user OAuth token for the specified team integration\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Create Slack User OAuth Token","parameters":[{"in":"path","name":"slack_team_integration_id","schema":{"type":"string"},"required":true}],"tags":["slack-teams"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackUserOauthTokenRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/SlackUserOauthTokenRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/SlackUserOauthTokenRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackUserOauthToken"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/slack-teams/{slack_team_integration_id}/oauth-tokens/{slack_user_id}/":{"get":{"operationId":"slack_teams_oauth_tokens_retrieve","description":"Retrieve a specific Slack user OAuth token by Slack user ID for the specified team integration\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Retrieve Slack User OAuth Token","parameters":[{"in":"path","name":"slack_team_integration_id","schema":{"type":"string"},"required":true},{"in":"path","name":"slack_user_id","schema":{"type":"string"},"required":true}],"tags":["slack-teams"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackUserOauthToken"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"delete":{"operationId":"slack_teams_oauth_tokens_destroy","description":"Delete a Slack user OAuth token by Slack user ID for the specified team integration\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Delete Slack User OAuth Token","parameters":[{"in":"path","name":"slack_team_integration_id","schema":{"type":"string"},"required":true},{"in":"path","name":"slack_user_id","schema":{"type":"string"},"required":true}],"tags":["slack-teams"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/slack-teams/{id}/":{"get":{"operationId":"slack_teams_retrieve","summary":"Retrieve Slack Team","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this slack team integration.","required":true}],"tags":["slack-teams"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackTeamIntegration"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"put":{"operationId":"slack_teams_update","description":"Handle updates to the SlackTeamIntegration.\nIf the integration is in INVITED state, transition it to JOINING state.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Update Slack Team","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this slack team integration.","required":true}],"tags":["slack-teams"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackTeamIntegrationRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/SlackTeamIntegrationRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/SlackTeamIntegrationRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackTeamIntegration"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"patch":{"operationId":"slack_teams_partial_update","summary":"Partial Update Slack Team","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this slack team integration.","required":true}],"tags":["slack-teams"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedSlackTeamIntegrationRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedSlackTeamIntegrationRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedSlackTeamIntegrationRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackTeamIntegration"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"},"delete":{"operationId":"slack_teams_destroy","summary":"Delete Slack Team","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this slack team integration.","required":true}],"tags":["slack-teams"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}],"description":"The base rate limit for this endpoint is:\n- 300 requests per min per workspace"}},"/api/v2/zoom-meetings-to-credentials/":{"get":{"operationId":"zoom_meetings_to_credentials_list","description":"Get a list of all mappings from Zoom Meeting ID to Zoom OAuth Credential. Recall uses mappings internally to determine which credential to use when automatically fetching join tokens for a meeting. Inspecting these mappings may be helpful when debugging bots that don't automatically record due to being unable to fetch join tokens.\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Zoom Meeting to OAuth Credential Mappings","parameters":[{"in":"query","name":"credential","schema":{"type":"string","format":"uuid"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"meeting_id","schema":{"type":"integer"}},{"name":"ordering","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}},{"in":"query","name":"synced_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"synced_at_before","schema":{"type":"string","format":"date-time"}}],"tags":["zoom-meetings-to-credentials"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedZoomMeetingToCredentialList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]}},"/api/v2/zoom-oauth-app-logs/":{"get":{"operationId":"zoom_oauth_app_logs_list","description":"Get a list of all Zoom OAuth App Logs. Any warnings or errors related to the OAuth App will be logged here, and this can be helpful for debugging.\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Zoom OAuth App Logs","parameters":[{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"oauth_app","schema":{"type":"string","format":"uuid"}},{"name":"ordering","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}}],"tags":["zoom-oauth-apps"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedZoomOAuthAppLogList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]}},"/api/v2/zoom-oauth-apps/":{"get":{"operationId":"zoom_oauth_apps_list","description":"Get a list of all Zoom OAuth Apps.\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Zoom OAuth Apps","parameters":[{"in":"query","name":"client_id","schema":{"type":"string"}},{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"kind","schema":{"type":"string"}},{"name":"ordering","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}},{"in":"query","name":"webhook_last_validation_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"webhook_last_validation_before","schema":{"type":"string","format":"date-time"}}],"tags":["zoom-oauth-apps"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedZoomOAuthAppList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]},"post":{"operationId":"zoom_oauth_apps_create","description":"Create a new Zoom OAuth App.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Create Zoom OAuth App","tags":["zoom-oauth-apps"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoomOAuthAppRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/ZoomOAuthAppRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/ZoomOAuthAppRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoomOAuthApp"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/zoom-oauth-apps/{id}/":{"get":{"operationId":"zoom_oauth_apps_retrieve","description":"Get a Zoom OAuth App.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Retrieve Zoom OAuth App","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this zoom o auth app.","required":true}],"tags":["zoom-oauth-apps"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoomOAuthApp"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"patch":{"operationId":"zoom_oauth_apps_partial_update","description":"Update an existing Zoom OAuth App\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Update Zoom OAuth App","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this zoom o auth app.","required":true}],"tags":["zoom-oauth-apps"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedZoomOAuthAppPartialUpdateRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedZoomOAuthAppPartialUpdateRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedZoomOAuthAppPartialUpdateRequest"}}}},"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoomOAuthApp"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"delete":{"operationId":"zoom_oauth_apps_destroy","description":"Deletes a Zoom OAuth App.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Destroy Zoom OAuth App","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this zoom o auth app.","required":true}],"tags":["zoom-oauth-apps"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/zoom-oauth-credential-logs/":{"get":{"operationId":"zoom_oauth_credential_logs_list","description":"Get a list of all Zoom OAuth Credential Logs. Any warnings or errors related to the OAuth Credential will be logged here, and this can be helpful for debugging.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"List Zoom OAuth Credential Logs","parameters":[{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"credential","schema":{"type":"string","format":"uuid"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"name":"ordering","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}}],"tags":["zoom-oauth-credentials"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedZoomOAuthCredentialLogList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/zoom-oauth-credentials/":{"get":{"operationId":"zoom_oauth_credentials_list","description":"Get a list of all Zoom OAuth Credentials\n\nThe base rate limit for this endpoint is:\n- 60 requests per min per workspace","summary":"List Zoom OAuth Credentials","parameters":[{"in":"query","name":"account_id","schema":{"type":"string"}},{"in":"query","name":"created_at_after","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"created_at_before","schema":{"type":"string","format":"date-time"}},{"name":"cursor","required":false,"in":"query","description":"The pagination cursor value.","schema":{"type":"string"}},{"in":"query","name":"meeting_sync_status","schema":{"type":"string","enum":["completed","failed","in_progress","not_started"]},"description":"This field tracks the status of initial meeting sync on the credential. This operation is processed asynchronously when the credential is created or when the sync meetings endpoint is called.\n\n* `not_started` - Not Started\n* `in_progress` - In Progress\n* `completed` - Completed\n* `failed` - Failed"},{"in":"query","name":"oauth_app","schema":{"type":"string","format":"uuid"}},{"name":"ordering","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}},{"in":"query","name":"status","schema":{"type":"string","enum":["healthy","unhealthy"]},"description":"* `healthy` - Healthy\n* `unhealthy` - Unhealthy"},{"in":"query","name":"user_id","schema":{"type":"string"}}],"tags":["zoom-oauth-credentials"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedZoomOAuthCredentialList"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":60,"period":"min"}]},"post":{"operationId":"zoom_oauth_credentials_create","description":"Create a new Zoom OAuth Credential.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Create Zoom OAuth Credential","tags":["zoom-oauth-credentials"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoomOAuthCredentialRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/ZoomOAuthCredentialRequest"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/ZoomOAuthCredentialRequest"}}},"required":true},"security":[{"tokenAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoomOAuthCredential"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoomOAuthCredentialBadRequest"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/zoom-oauth-credentials/{id}/":{"get":{"operationId":"zoom_oauth_credentials_retrieve","description":"Get a Zoom OAuth Credential.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Retrieve Zoom OAuth Credential","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this zoom o auth credential.","required":true}],"tags":["zoom-oauth-credentials"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoomOAuthCredential"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]},"delete":{"operationId":"zoom_oauth_credentials_destroy","description":"Deletes a Zoom OAuth Credential.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Destroy Zoom OAuth Credential","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this zoom o auth credential.","required":true}],"tags":["zoom-oauth-credentials"],"security":[{"tokenAuth":[]}],"responses":{"204":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/zoom-oauth-credentials/{id}/access-token/":{"get":{"operationId":"zoom_oauth_credentials_access_token_retrieve","description":"Get the access token for these credentials.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Get Access Token","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this zoom o auth credential.","required":true}],"tags":["zoom-oauth-credentials"],"security":[{"tokenAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZoomAccessToken"}}},"description":""}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/zoom-oauth-credentials/{id}/sync-meetings/":{"post":{"operationId":"zoom_oauth_credentials_sync_meetings_create","description":"Manually re-sync meetings accessible from these credentials. This operation is asynchronous, and may take some time to complete.Use the `meeting_sync_status` field on the credential object to check status of sync.This is ONLY useful for debugging, and should not be called on a regular basis. Meetings are ordinarily automatically synced.\n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Manually Resync Meetings","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this zoom o auth credential.","required":true}],"tags":["zoom-oauth-credentials"],"security":[{"tokenAuth":[]}],"responses":{"200":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}},"/api/v2/zoom-oauth-credentials/{id}/validate/":{"post":{"operationId":"zoom_oauth_credentials_validate_create","description":"Manually check the validity of credentials, and re-enable them if they are functional. This can be useful if credentials are disabled due to repeated errors. \n\nThe base rate limit for this endpoint is:\n- 300 requests per min per workspace","summary":"Manually Revalidate Credential","parameters":[{"in":"path","name":"id","schema":{"type":"string","format":"uuid"},"description":"A UUID string identifying this zoom o auth credential.","required":true}],"tags":["zoom-oauth-credentials"],"security":[{"tokenAuth":[]}],"responses":{"200":{"description":"No response body"}},"x-throttles":[{"scope_key":"workspace_id","limit":300,"period":"min"}]}}},"components":{"schemas":{"ArtifactStatus":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ArtifactStatusCodeEnum"},"sub_code":{"type":"string","nullable":true},"updated_at":{"type":"string","format":"date-time"}},"required":["code","sub_code","updated_at"]},"ArtifactStatusCodeEnum":{"enum":["processing","done","failed","deleted"],"type":"string","description":"* `processing` - Processing\n* `done` - Done\n* `failed` - Failed\n* `deleted` - Deleted"},"ArtifactStatusRequest":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ArtifactStatusCodeEnum"},"sub_code":{"type":"string","nullable":true,"minLength":1},"updated_at":{"type":"string","format":"date-time"}},"required":["code","sub_code","updated_at"]},"AudioMixedArtifact":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"recording":{"allOf":[{"$ref":"#/components/schemas/RecordingMinimal"}],"readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/ArtifactStatus"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"data":{"allOf":[{"$ref":"#/components/schemas/AudioMixedArtifactData"}],"readOnly":true},"format":{"allOf":[{"$ref":"#/components/schemas/Format33bEnum"}],"readOnly":true,"description":"Format of the mixed audio file\n\n* `mp3` - Mp3\n* `raw` - Raw"}},"required":["created_at","data","format","id","metadata","recording","status"]},"AudioMixedArtifactData":{"type":"object","properties":{"download_url":{"type":"string","format":"uri","readOnly":true,"nullable":true}},"required":["download_url"]},"AudioMixedArtifactShortcut":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/ArtifactStatus"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"data":{"allOf":[{"$ref":"#/components/schemas/AudioMixedArtifactData"}],"readOnly":true},"format":{"allOf":[{"$ref":"#/components/schemas/Format33bEnum"}],"readOnly":true,"description":"Format of the mixed audio file\n\n* `mp3` - Mp3\n* `raw` - Raw"}},"required":["created_at","data","format","id","metadata","status"]},"AudioMixedArtifactShortcutRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}},"required":["metadata"]},"AudioOutput":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AudioOutputData"},"replay_on_participant_join":{"allOf":[{"$ref":"#/components/schemas/AudioOutputReplay"}],"description":"Specify this parameter if you want the audio to be replayed when additional participants join the call."}},"required":["data"]},"AudioOutputData":{"type":"object","properties":{"kind":{"allOf":[{"$ref":"#/components/schemas/AudioOutputDataKindEnum"}],"description":"The kind of data encoded in b64_data\n\n* `mp3` - mp3"}},"required":["kind"]},"AudioOutputDataKindEnum":{"enum":["mp3"],"type":"string","description":"* `mp3` - mp3"},"AudioOutputDataRequest":{"type":"object","properties":{"kind":{"allOf":[{"$ref":"#/components/schemas/AudioOutputDataKindEnum"}],"description":"The kind of data encoded in b64_data\n\n* `mp3` - mp3"},"b64_data":{"type":"string","writeOnly":true,"minLength":1,"description":"Data encoded in Base64 format, using the standard alphabet (specified here: https://datatracker.ietf.org/doc/html/rfc4648#section-4)","maxLength":1835008}},"required":["b64_data","kind"]},"AudioOutputReplay":{"type":"object","properties":{"debounce_mode":{"allOf":[{"$ref":"#/components/schemas/DebounceModeEnum"}],"default":"trailing","description":"Leading: The debounce timer will start counting down when the first participant joins.\nTrailing: The debounce timer will start counting down when the last participant joins.\nFor example with a debounce_interval of 10, if two participants join 9 seconds apart: \n - In `Leading` mode the audio will play 10 seconds after the 1st participant joined (1 second after the 2nd participant)\n - In `Trailing` mode the audio will play 10 seconds after the 2nd participant joined (19 seconds after the 1st participant)\n\n* `leading` - leading\n* `trailing` - trailing"},"debounce_interval":{"type":"integer","description":"The amount of time to wait for additional participants to join before replaying the audio."},"disable_after":{"type":"integer","description":"The number of seconds after which the audio will no longer replay when new participants join. This parameter is useful to prevent the bot from interrupting a meeting, if a late participant joins."}},"required":["debounce_interval"]},"AudioOutputReplayRequest":{"type":"object","properties":{"debounce_mode":{"allOf":[{"$ref":"#/components/schemas/DebounceModeEnum"}],"default":"trailing","description":"Leading: The debounce timer will start counting down when the first participant joins.\nTrailing: The debounce timer will start counting down when the last participant joins.\nFor example with a debounce_interval of 10, if two participants join 9 seconds apart: \n - In `Leading` mode the audio will play 10 seconds after the 1st participant joined (1 second after the 2nd participant)\n - In `Trailing` mode the audio will play 10 seconds after the 2nd participant joined (19 seconds after the 1st participant)\n\n* `leading` - leading\n* `trailing` - trailing"},"debounce_interval":{"type":"integer","description":"The amount of time to wait for additional participants to join before replaying the audio."},"disable_after":{"type":"integer","description":"The number of seconds after which the audio will no longer replay when new participants join. This parameter is useful to prevent the bot from interrupting a meeting, if a late participant joins."}},"required":["debounce_interval"]},"AudioOutputRequest":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AudioOutputDataRequest"},"replay_on_participant_join":{"allOf":[{"$ref":"#/components/schemas/AudioOutputReplayRequest"}],"description":"Specify this parameter if you want the audio to be replayed when additional participants join the call."}},"required":["data"]},"AudioSeparateArtifact":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"recording":{"allOf":[{"$ref":"#/components/schemas/RecordingMinimal"}],"readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/ArtifactStatus"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"data":{"allOf":[{"$ref":"#/components/schemas/AudioSeparateArtifactData"}],"readOnly":true},"format":{"allOf":[{"$ref":"#/components/schemas/AudioSeparateArtifactFormatEnum"}],"readOnly":true,"description":"Format of the participant separated audio files\n\n* `raw` - Raw\n* `ogg` - Ogg"}},"required":["created_at","data","format","id","metadata","recording","status"]},"AudioSeparateArtifactData":{"type":"object","properties":{"download_url":{"type":"string","format":"uri","readOnly":true,"nullable":true,"description":"Download all audio separate parts for the recording. **[See response format here](https://docs.recall.ai/docs/download-schemas#json-audio-separate-download-url)**"}},"required":["download_url"]},"AudioSeparateArtifactFormatEnum":{"enum":["raw","ogg"],"type":"string","description":"* `raw` - Raw\n* `ogg` - Ogg"},"AutomaticAudioOutput":{"type":"object","properties":{"in_call_recording":{"$ref":"#/components/schemas/AudioOutput"}},"required":["in_call_recording"]},"AutomaticAudioOutputRequest":{"type":"object","properties":{"in_call_recording":{"$ref":"#/components/schemas/AudioOutputRequest"}},"required":["in_call_recording"]},"AutomaticLeave":{"type":"object","properties":{"waiting_room_timeout":{"type":"integer","minimum":30,"default":1200,"description":"The number of seconds after which the bot will automatically leave the call, if it has not been let in from the waiting room. If you join Zoom using an OBF token, this timeout also caps how long the bot will wait for the associated user to join the meeting; if the user never joins before the timeout, the join fails with zoom_obf_user_not_in_meeting. Note that this has a max value of 600 seconds for Google Meet and 1800 for Microsoft Teams."},"noone_joined_timeout":{"type":"integer","minimum":30,"default":1200,"description":"The number of seconds after which the bot will automatically leave the call, if it has joined the meeting but no other participant has joined."},"everyone_left_timeout":{"allOf":[{"$ref":"#/components/schemas/AutomaticLeaveEveryoneLeft"}],"description":"The number of seconds after which the bot will automatically leave the call, if there were other participants in the call who have all left. Note: The everyone_left waiter remains active and will trigger even if recording is paused, unlike other automatic leave waiters which are paused when recording is paused."},"in_call_not_recording_timeout":{"type":"integer","minimum":1,"default":3600,"description":"The number of seconds after which the bot will automatically leave the call, if it has joined the call and is not recording.This includes all periods when the bot is not recording, even if the bot has recorded previously."},"in_call_recording_timeout":{"type":"integer","minimum":1,"description":"The number of seconds after which the bot will automatically leave the call, if it has joined the call and started recording it. This can be used to enforce a maximum recording time limit for a bot. There is no default value for this parameter, meaning a bot will continue to record for as long as the meeting lasts."},"recording_permission_denied_timeout":{"type":"integer","minimum":1,"default":30,"description":"The number of seconds after which the bot will automatically leave the call, if it has joined the call but has not started recording. For e.g This can occur due to bot being denied permission to record(Zoom meetings)."},"silence_detection":{"allOf":[{"$ref":"#/components/schemas/AutomaticLeaveSilenceDetection"}],"default":{"timeout":3600,"activate_after":1200}},"bot_detection":{"allOf":[{"$ref":"#/components/schemas/AutomaticLeaveBotDetection"}],"default":{"using_participant_events":{"timeout":600,"activate_after":1200},"using_participant_names":{"matches":["notetaker","recorder","assistant"],"timeout":600,"activate_after":120}}}}},"AutomaticLeaveBotDetection":{"type":"object","properties":{"using_participant_events":{"$ref":"#/components/schemas/AutomaticLeaveBotDetectionUsingParticipantEvents"},"using_participant_names":{"$ref":"#/components/schemas/AutomaticLeaveBotDetectionUsingParticipantNames"}}},"AutomaticLeaveBotDetectionRequest":{"type":"object","properties":{"using_participant_events":{"$ref":"#/components/schemas/AutomaticLeaveBotDetectionUsingParticipantEventsRequest"},"using_participant_names":{"$ref":"#/components/schemas/AutomaticLeaveBotDetectionUsingParticipantNamesRequest"}}},"AutomaticLeaveBotDetectionUsingParticipantEvents":{"type":"object","properties":{"timeout":{"type":"integer","minimum":10,"default":600,"description":"The number of seconds after which the bot will automatically leave the call if all other participants(in call) are detected as bots using this heuristic. A participant is considered a bot if they have no audio or screenshare activity for the duration of the call."},"activate_after":{"type":"integer","minimum":1,"default":1200,"description":"The number of seconds(post recording start) after which the bot will start detecting other participants as bots using this heuristic. This parameter can be helpful if the meeting tends to start late, so the bot does not preemptively leave."}}},"AutomaticLeaveBotDetectionUsingParticipantEventsRequest":{"type":"object","properties":{"timeout":{"type":"integer","minimum":10,"default":600,"description":"The number of seconds after which the bot will automatically leave the call if all other participants(in call) are detected as bots using this heuristic. A participant is considered a bot if they have no audio or screenshare activity for the duration of the call."},"activate_after":{"type":"integer","minimum":1,"default":1200,"description":"The number of seconds(post recording start) after which the bot will start detecting other participants as bots using this heuristic. This parameter can be helpful if the meeting tends to start late, so the bot does not preemptively leave."}}},"AutomaticLeaveBotDetectionUsingParticipantNames":{"type":"object","properties":{"timeout":{"type":"integer","minimum":10,"description":"The number of seconds after which the bot will automatically leave the call if all other participants(in call) are detected as bots using this heuristic. A participant is considered a bot if their name contains any of the strings specified in the `matches` parameter(case insensitive match)."},"activate_after":{"type":"integer","minimum":1,"description":"The number of seconds(post recording start) after which the bot will start detecting other participants as bots using this heuristic. This parameter can be helpful if the meeting tends to start late, so the bot does not preemptively leave."},"matches":{"type":"array","items":{"type":"string"},"description":"A list of strings that the bot will use to detect other bots. If a participant's name contains any of these strings(case insensitive match), they will be considered a bot. If all remaining participants in the call are detected as bots(except the bot itself), the bot will automatically leave the call.For e.g ['notetaker', 'recorder', 'assistant']"}},"required":["activate_after","matches","timeout"]},"AutomaticLeaveBotDetectionUsingParticipantNamesRequest":{"type":"object","properties":{"timeout":{"type":"integer","minimum":10,"description":"The number of seconds after which the bot will automatically leave the call if all other participants(in call) are detected as bots using this heuristic. A participant is considered a bot if their name contains any of the strings specified in the `matches` parameter(case insensitive match)."},"activate_after":{"type":"integer","minimum":1,"description":"The number of seconds(post recording start) after which the bot will start detecting other participants as bots using this heuristic. This parameter can be helpful if the meeting tends to start late, so the bot does not preemptively leave."},"matches":{"type":"array","items":{"type":"string","minLength":1},"description":"A list of strings that the bot will use to detect other bots. If a participant's name contains any of these strings(case insensitive match), they will be considered a bot. If all remaining participants in the call are detected as bots(except the bot itself), the bot will automatically leave the call.For e.g ['notetaker', 'recorder', 'assistant']"}},"required":["activate_after","matches","timeout"]},"AutomaticLeaveEveryoneLeft":{"type":"object","properties":{"timeout":{"type":"integer","minimum":1,"default":2,"description":"The number of seconds after which the bot will automatically leave the call, if there were other participants in the call who have all left."},"activate_after":{"type":"integer","minimum":1,"nullable":true,"description":"The number of seconds after which the bot will start detecting everyone left once it has started recording the call. "}}},"AutomaticLeaveEveryoneLeftRequest":{"type":"object","properties":{"timeout":{"type":"integer","minimum":1,"default":2,"description":"The number of seconds after which the bot will automatically leave the call, if there were other participants in the call who have all left."},"activate_after":{"type":"integer","minimum":1,"nullable":true,"description":"The number of seconds after which the bot will start detecting everyone left once it has started recording the call. "}}},"AutomaticLeaveRequest":{"type":"object","properties":{"waiting_room_timeout":{"type":"integer","minimum":30,"default":1200,"description":"The number of seconds after which the bot will automatically leave the call, if it has not been let in from the waiting room. If you join Zoom using an OBF token, this timeout also caps how long the bot will wait for the associated user to join the meeting; if the user never joins before the timeout, the join fails with zoom_obf_user_not_in_meeting. Note that this has a max value of 600 seconds for Google Meet and 1800 for Microsoft Teams."},"noone_joined_timeout":{"type":"integer","minimum":30,"default":1200,"description":"The number of seconds after which the bot will automatically leave the call, if it has joined the meeting but no other participant has joined."},"everyone_left_timeout":{"allOf":[{"$ref":"#/components/schemas/AutomaticLeaveEveryoneLeftRequest"}],"description":"The number of seconds after which the bot will automatically leave the call, if there were other participants in the call who have all left. Note: The everyone_left waiter remains active and will trigger even if recording is paused, unlike other automatic leave waiters which are paused when recording is paused."},"in_call_not_recording_timeout":{"type":"integer","minimum":1,"default":3600,"description":"The number of seconds after which the bot will automatically leave the call, if it has joined the call and is not recording.This includes all periods when the bot is not recording, even if the bot has recorded previously."},"in_call_recording_timeout":{"type":"integer","minimum":1,"description":"The number of seconds after which the bot will automatically leave the call, if it has joined the call and started recording it. This can be used to enforce a maximum recording time limit for a bot. There is no default value for this parameter, meaning a bot will continue to record for as long as the meeting lasts."},"recording_permission_denied_timeout":{"type":"integer","minimum":1,"default":30,"description":"The number of seconds after which the bot will automatically leave the call, if it has joined the call but has not started recording. For e.g This can occur due to bot being denied permission to record(Zoom meetings)."},"silence_detection":{"allOf":[{"$ref":"#/components/schemas/AutomaticLeaveSilenceDetectionRequest"}],"default":{"timeout":3600,"activate_after":1200}},"bot_detection":{"allOf":[{"$ref":"#/components/schemas/AutomaticLeaveBotDetectionRequest"}],"default":{"using_participant_events":{"timeout":600,"activate_after":1200},"using_participant_names":{"matches":["notetaker","recorder","assistant"],"timeout":600,"activate_after":120}}}}},"AutomaticLeaveSilenceDetection":{"type":"object","properties":{"timeout":{"type":"integer","minimum":10,"default":3600,"description":"The number of seconds of continuous silence after which the bot will automatically leave the call."},"activate_after":{"type":"integer","minimum":1,"default":1200,"description":"The number of seconds after which the bot will start detecting silence once it has started recording the call. This parameter can be helpful if the meeting tends to start late, so the bot does not preemptively leave."}}},"AutomaticLeaveSilenceDetectionRequest":{"type":"object","properties":{"timeout":{"type":"integer","minimum":10,"default":3600,"description":"The number of seconds of continuous silence after which the bot will automatically leave the call."},"activate_after":{"type":"integer","minimum":1,"default":1200,"description":"The number of seconds after which the bot will start detecting silence once it has started recording the call. This parameter can be helpful if the meeting tends to start late, so the bot does not preemptively leave."}}},"AutomaticVideoOutput":{"type":"object","properties":{"in_call_recording":{"allOf":[{"$ref":"#/components/schemas/VideoOutput"}],"description":"The video that will be automatically output when the bot is in the **in_call_recording** state."},"in_call_not_recording":{"allOf":[{"$ref":"#/components/schemas/VideoOutput"}],"description":"The video that will be automatically output when the bot is in the **in_call_not_recording** state. If not specified the bot will fallback to in_call_recording output if available."}}},"AutomaticVideoOutputRequest":{"type":"object","properties":{"in_call_recording":{"allOf":[{"$ref":"#/components/schemas/VideoOutputRequest"}],"description":"The video that will be automatically output when the bot is in the **in_call_recording** state."},"in_call_not_recording":{"allOf":[{"$ref":"#/components/schemas/VideoOutputRequest"}],"description":"The video that will be automatically output when the bot is in the **in_call_not_recording** state. If not specified the bot will fallback to in_call_recording output if available."}}},"Bot":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"meeting_url":{"allOf":[{"$ref":"#/components/schemas/MeetingInvite"}],"description":"The url of the meeting. For example, https://zoom.us/j/123?pwd=456. This field will be cleared a few days after the bot has joined a call."},"bot_name":{"type":"string","default":"Meeting Notetaker","description":"The name of the bot that will be displayed in the call.\n*(Note: Authenticated Google Meet bots will use the Google account name and this field will be ignored.)*","maxLength":100},"join_at":{"type":"string","format":"date-time","nullable":true,"description":"The time at which the bot will join the call, formatted in ISO 8601. This field can only be read from scheduled bots that have not yet joined a call."},"recording_config":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfig"}],"nullable":true,"description":"Configure the recording generated by the bot. Includes options for getting meeting transcript,  the layout of the recorded video, when to start recording and more."},"status_changes":{"type":"array","items":{"$ref":"#/components/schemas/BotEvent"},"readOnly":true},"recordings":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingEmbed"},"readOnly":true},"output_media":{"allOf":[{"$ref":"#/components/schemas/OutputMedia"}],"nullable":true,"description":"Settings for the bot output media."},"automatic_video_output":{"allOf":[{"$ref":"#/components/schemas/AutomaticVideoOutput"}],"nullable":true,"description":"Settings for the bot to output video. Image should be 16:9. Read more about this here: https://docs.recall.ai/docs/output-video-in-meetings"},"automatic_audio_output":{"allOf":[{"$ref":"#/components/schemas/AutomaticAudioOutput"}],"nullable":true,"description":"Settings for the bot to output audio."},"chat":{"allOf":[{"$ref":"#/components/schemas/Chat"}],"nullable":true,"description":"Settings for the bot to send chat messages. \n*(Note: Chat functionality is only supported for Zoom, Google Meet and Microsoft Teams currently.)*"},"automatic_leave":{"allOf":[{"$ref":"#/components/schemas/AutomaticLeave"}],"nullable":true},"variant":{"allOf":[{"$ref":"#/components/schemas/BotVariant"}],"nullable":true,"description":"Configure bot variants per meeting platforms, e.g. {\"zoom\": \"web_4_core\"}."},"calendar_meetings":{"type":"array","items":{"$ref":"#/components/schemas/BotCalendarMeeting"},"readOnly":true,"description":"The calendar meetings associated with this bot. This field is **populated only for bots that are dispatched via Calendar V1 API integration**."},"zoom":{"allOf":[{"$ref":"#/components/schemas/Zoom"}],"nullable":true,"description":"Zoom specific parameters"},"google_meet":{"allOf":[{"$ref":"#/components/schemas/GoogleMeet"}],"nullable":true,"description":"Google Meet specific parameters"},"slack_team":{"allOf":[{"$ref":"#/components/schemas/SlackTeamIntegrationMinimal"}],"readOnly":true,"nullable":true},"webex":{"allOf":[{"$ref":"#/components/schemas/Webex"}],"nullable":true,"description":"Webex specific parameters"},"breakout_room":{"allOf":[{"$ref":"#/components/schemas/_BreakoutRoomSchema"}],"nullable":true,"description":"Configure how the bot handles breakout rooms. Currently, Zoom is supported.Examples: {\"mode\": \"join_main_room\"} | {\"mode\": \"join_specific_room\", \"room_id\": \"<uuid>\"} | {\"mode\": \"auto_accept_all_invites\"} (default)."},"metadata":{"type":"object","additionalProperties":{"type":"string"}}},"required":["calendar_meetings","id","meeting_url","recordings","status_changes"]},"BotCalendarMeeting":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"start_time":{"type":"string","format":"date-time","readOnly":true},"end_time":{"type":"string","format":"date-time","readOnly":true},"calendar_user":{"allOf":[{"$ref":"#/components/schemas/BotCalendarUser"}],"readOnly":true}},"required":["calendar_user","end_time","id","start_time"]},"BotCalendarUser":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"external_id":{"type":"string","readOnly":true}},"required":["external_id","id"]},"BotEvent":{"type":"object","properties":{"code":{"type":"string","readOnly":true},"message":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"sub_code":{"type":"string","readOnly":true}},"required":["code","created_at","message","sub_code"]},"BotIncludeInRecording":{"type":"object","properties":{"audio":{"type":"boolean","default":false,"description":"Whether to record audio from the bot."}}},"BotIncludeInRecordingRequest":{"type":"object","properties":{"audio":{"type":"boolean","default":false,"description":"Whether to record audio from the bot."}}},"BotMinimal":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"},"readOnly":true}},"required":["id","metadata"]},"BotRecordingConfig":{"type":"object","properties":{"transcript":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigTranscriptArtifact"}],"nullable":true,"description":"Specify this to capture transcript of the meeting as part of the recording. Supports:\n- [Recall.ai Transcription](https://docs.recall.ai/docs/recallai-transcription)\n- [3rd-party AI transcription providers](https://docs.recall.ai/docs/ai-transcription)\n- [meeting caption transcription](https://docs.recall.ai/docs/meeting-caption-transcription)\n\n **[Read more about real-time transcription.](https://docs.recall.ai/docs/bot-real-time-transcription)**\n\nDefault: `null`\n\n"},"realtime_endpoints":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpoint"},"default":[],"description":"Add endpoints here to receive data (e.g transcript, participant events) from the recording in realtime during the meeting.\n\nDefault: `[]`\n\n"},"retention":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetention"}],"nullable":true,"description":"Specify the retention policy for the recording. **[Read more in this guide](https://docs.recall.ai/docs/storage-and-playback)**"},"video_mixed_layout":{"allOf":[{"$ref":"#/components/schemas/VideoMixedLayoutEnum"}],"default":"speaker_view","description":"The layout of the mixed video output.\n\n* `speaker_view` - speaker_view\n* `gallery_view` - gallery_view\n* `gallery_view_v2` - gallery_view_v2\n* `audio_only` - audio_only"},"video_mixed_mp4":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Capture mixed video of the meeting as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"participant_events":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"default":{},"description":"Capture participant events as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"meeting_metadata":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"default":{},"description":"Capture meeting metadata as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"video_mixed_participant_video_when_screenshare":{"allOf":[{"$ref":"#/components/schemas/VideoMixedParticipantVideoWhenScreenshareEnum"}],"default":"overlap","description":"The layout of participant video streams in mixed video output when screen is being shared. More docs: https://docs.recall.ai/docs/video-layouts\n\n* `hide` - hide\n* `beside` - beside\n* `overlap` - overlap"},"start_recording_on":{"allOf":[{"$ref":"#/components/schemas/StartRecordingOnEnum"}],"default":"participant_join","description":"Specify when automatic recording should start.\n*call_join* - Bot will start recording as soon as it joins the call.\n*participant_join* - Bot will start recording when the first participant joins the call. If a participant is already present when the bot joins, the bot will automatically start recording.\n*participant_speak* - Bot will start recording when the first participant starts talking.\n\n\n* `call_join` - call_join\n* `participant_join` - participant_join\n* `participant_speak` - participant_speak"},"include_bot_in_recording":{"$ref":"#/components/schemas/BotIncludeInRecording"},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"audio_mixed_raw":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture mixed audio in raw format of the meeting.\n\nDefault: `null`\n\n"},"audio_mixed_mp3":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture mixed audio in the mp3 format of the meeting\n\nDefault: `null`\n\n"},"video_separate_mp4":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture separate video in mp4 format for each participant in the meeting. Only supported with video_mixed_layout='gallery_view_v2'. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-videos-per-participant-async)**\n\nDefault: `null`\n\n"},"audio_separate_raw":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture separate audio in raw format for each participant in the meeting(**limited support**).  **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-audio-per-participant-async)**\n\nDefault: `null`\n\n"},"audio_separate_mp3":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture separate audio in mp3 format for each participant in the meeting. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-audio-per-participant-async)**\n\nDefault: `null`\n\n"},"video_mixed_flv":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture mixed video in flv format(**required for rtmp streaming). \n\nDefault: `null`\n\n"},"video_separate_png":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture separate video in png format for each participant in the meeting. Only supported with video_mixed_layout='gallery_view_v2'. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-videos-per-participant-realtime)**\n\nDefault: `null`\n\n"},"video_separate_h264":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture separate video in compressed h264 for each participant in the meeting. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-videos-per-participant-realtime)**\n\nDefault: `null`\n\n"}}},"BotRecordingConfigBaseArtifact":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"BotRecordingConfigBaseArtifactRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"BotRecordingConfigRealtimeEndpoint":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}},"type":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointSharedTypeEnum"}],"description":"The type of the realtime endpoint.\n\n* `rtmp` - Rtmp\n* `websocket` - Websocket\n* `webhook` - Webhook\n* `desktop_sdk_callback` - Desktop Sdk Callback"},"url":{"type":"string","description":"The URL of the realtime endpoint.","format":"uri"},"events":{"type":"array","items":{"type":"string"},"description":"The events to send to the realtime endpoint."}},"required":["type"]},"BotRecordingConfigRealtimeEndpointBotRecordingConfigRealtimeEndpointDesktopSdkCallback":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointShared"},{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointDesktopSdkCallback"}]},"BotRecordingConfigRealtimeEndpointBotRecordingConfigRealtimeEndpointDesktopSdkCallbackRequest":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointShared"},{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointDesktopSdkCallbackRequest"}]},"BotRecordingConfigRealtimeEndpointBotRecordingConfigRealtimeEndpointRtmp":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointShared"},{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointRtmp"}]},"BotRecordingConfigRealtimeEndpointBotRecordingConfigRealtimeEndpointRtmpRequest":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointShared"},{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointRtmpRequest"}]},"BotRecordingConfigRealtimeEndpointBotRecordingConfigRealtimeEndpointWebhook":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointShared"},{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointWebhook"}]},"BotRecordingConfigRealtimeEndpointBotRecordingConfigRealtimeEndpointWebhookRequest":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointShared"},{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointWebhookRequest"}]},"BotRecordingConfigRealtimeEndpointBotRecordingConfigRealtimeEndpointWebsocket":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointShared"},{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointWebsocket"}]},"BotRecordingConfigRealtimeEndpointBotRecordingConfigRealtimeEndpointWebsocketRequest":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointShared"},{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointWebsocketRequest"}]},"BotRecordingConfigRealtimeEndpointDesktopSdkCallback":{"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointDesktopSdkCallbackEventsEnum"},"description":"The events to send to the realtime endpoint."}},"required":["events"]},"BotRecordingConfigRealtimeEndpointDesktopSdkCallbackEventsEnum":{"enum":["participant_events.join","participant_events.leave","participant_events.update","participant_events.speech_on","participant_events.speech_off","participant_events.webcam_on","participant_events.webcam_off","participant_events.screenshare_on","participant_events.screenshare_off","participant_events.chat_message","transcript.data","transcript.partial_data","transcript.provider_data","video_separate_png.data","video_separate_h264.data","audio_mixed_raw.data"],"type":"string","description":"* `participant_events.join` - participant_events.join\n* `participant_events.leave` - participant_events.leave\n* `participant_events.update` - participant_events.update\n* `participant_events.speech_on` - participant_events.speech_on\n* `participant_events.speech_off` - participant_events.speech_off\n* `participant_events.webcam_on` - participant_events.webcam_on\n* `participant_events.webcam_off` - participant_events.webcam_off\n* `participant_events.screenshare_on` - participant_events.screenshare_on\n* `participant_events.screenshare_off` - participant_events.screenshare_off\n* `participant_events.chat_message` - participant_events.chat_message\n* `transcript.data` - transcript.data\n* `transcript.partial_data` - transcript.partial_data\n* `transcript.provider_data` - transcript.provider_data\n* `video_separate_png.data` - video_separate_png.data\n* `video_separate_h264.data` - video_separate_h264.data\n* `audio_mixed_raw.data` - audio_mixed_raw.data"},"BotRecordingConfigRealtimeEndpointDesktopSdkCallbackRequest":{"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointDesktopSdkCallbackEventsEnum"},"description":"The events to send to the realtime endpoint."}},"required":["events"]},"BotRecordingConfigRealtimeEndpointRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}},"type":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointSharedTypeEnum"}],"description":"The type of the realtime endpoint.\n\n* `rtmp` - Rtmp\n* `websocket` - Websocket\n* `webhook` - Webhook\n* `desktop_sdk_callback` - Desktop Sdk Callback"},"url":{"type":"string","minLength":1,"description":"The URL of the realtime endpoint.","format":"uri"},"events":{"type":"array","items":{"type":"string"},"description":"The events to send to the realtime endpoint."}},"required":["type"]},"BotRecordingConfigRealtimeEndpointRtmp":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the realtime endpoint.","format":"uri"},"events":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointRtmpEventsEnum"},"description":"The events to send to the realtime endpoint."}},"required":["events","url"]},"BotRecordingConfigRealtimeEndpointRtmpEventsEnum":{"enum":["video_mixed_flv.data"],"type":"string","description":"* `video_mixed_flv.data` - video_mixed_flv.data"},"BotRecordingConfigRealtimeEndpointRtmpRequest":{"type":"object","properties":{"url":{"type":"string","minLength":1,"description":"The URL of the realtime endpoint.","format":"uri"},"events":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointRtmpEventsEnum"},"description":"The events to send to the realtime endpoint."}},"required":["events","url"]},"BotRecordingConfigRealtimeEndpointShared":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}},"type":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointSharedTypeEnum"}],"description":"The type of the realtime endpoint.\n\n* `rtmp` - Rtmp\n* `websocket` - Websocket\n* `webhook` - Webhook\n* `desktop_sdk_callback` - Desktop Sdk Callback"}},"required":["type"]},"BotRecordingConfigRealtimeEndpointSharedTypeEnum":{"enum":["rtmp","websocket","webhook","desktop_sdk_callback"],"type":"string","description":"* `rtmp` - Rtmp\n* `websocket` - Websocket\n* `webhook` - Webhook\n* `desktop_sdk_callback` - Desktop Sdk Callback"},"BotRecordingConfigRealtimeEndpointWebhook":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the realtime endpoint.","format":"uri"},"events":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointWebhookEventsEnum"},"description":"The events to send to the realtime endpoint."}},"required":["events","url"]},"BotRecordingConfigRealtimeEndpointWebhookEventsEnum":{"enum":["participant_events.join","participant_events.leave","participant_events.update","participant_events.speech_on","participant_events.speech_off","participant_events.webcam_on","participant_events.webcam_off","participant_events.screenshare_on","participant_events.screenshare_off","participant_events.chat_message","transcript.data","transcript.partial_data","transcript.provider_data"],"type":"string","description":"* `participant_events.join` - participant_events.join\n* `participant_events.leave` - participant_events.leave\n* `participant_events.update` - participant_events.update\n* `participant_events.speech_on` - participant_events.speech_on\n* `participant_events.speech_off` - participant_events.speech_off\n* `participant_events.webcam_on` - participant_events.webcam_on\n* `participant_events.webcam_off` - participant_events.webcam_off\n* `participant_events.screenshare_on` - participant_events.screenshare_on\n* `participant_events.screenshare_off` - participant_events.screenshare_off\n* `participant_events.chat_message` - participant_events.chat_message\n* `transcript.data` - transcript.data\n* `transcript.partial_data` - transcript.partial_data\n* `transcript.provider_data` - transcript.provider_data"},"BotRecordingConfigRealtimeEndpointWebhookRequest":{"type":"object","properties":{"url":{"type":"string","minLength":1,"description":"The URL of the realtime endpoint.","format":"uri"},"events":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointWebhookEventsEnum"},"description":"The events to send to the realtime endpoint."}},"required":["events","url"]},"BotRecordingConfigRealtimeEndpointWebsocket":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the realtime endpoint.","format":"uri"},"events":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointWebsocketEventsEnum"},"description":"The events to send to the realtime endpoint."}},"required":["events","url"]},"BotRecordingConfigRealtimeEndpointWebsocketEventsEnum":{"enum":["participant_events.join","participant_events.leave","participant_events.update","participant_events.speech_on","participant_events.speech_off","participant_events.webcam_on","participant_events.webcam_off","participant_events.screenshare_on","participant_events.screenshare_off","participant_events.chat_message","audio_mixed_raw.data","transcript.data","transcript.partial_data","transcript.provider_data","audio_separate_raw.data","video_separate_png.data","video_separate_h264.data"],"type":"string","description":"* `participant_events.join` - participant_events.join\n* `participant_events.leave` - participant_events.leave\n* `participant_events.update` - participant_events.update\n* `participant_events.speech_on` - participant_events.speech_on\n* `participant_events.speech_off` - participant_events.speech_off\n* `participant_events.webcam_on` - participant_events.webcam_on\n* `participant_events.webcam_off` - participant_events.webcam_off\n* `participant_events.screenshare_on` - participant_events.screenshare_on\n* `participant_events.screenshare_off` - participant_events.screenshare_off\n* `participant_events.chat_message` - participant_events.chat_message\n* `audio_mixed_raw.data` - audio_mixed_raw.data\n* `transcript.data` - transcript.data\n* `transcript.partial_data` - transcript.partial_data\n* `transcript.provider_data` - transcript.provider_data\n* `audio_separate_raw.data` - audio_separate_raw.data\n* `video_separate_png.data` - video_separate_png.data\n* `video_separate_h264.data` - video_separate_h264.data"},"BotRecordingConfigRealtimeEndpointWebsocketRequest":{"type":"object","properties":{"url":{"type":"string","minLength":1,"description":"The URL of the realtime endpoint.","format":"uri"},"events":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointWebsocketEventsEnum"},"description":"The events to send to the realtime endpoint."}},"required":["events","url"]},"BotRecordingConfigRequest":{"type":"object","properties":{"transcript":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigTranscriptArtifactRequest"}],"nullable":true,"description":"Specify this to capture transcript of the meeting as part of the recording. Supports:\n- [Recall.ai Transcription](https://docs.recall.ai/docs/recallai-transcription)\n- [3rd-party AI transcription providers](https://docs.recall.ai/docs/ai-transcription)\n- [meeting caption transcription](https://docs.recall.ai/docs/meeting-caption-transcription)\n\n **[Read more about real-time transcription.](https://docs.recall.ai/docs/bot-real-time-transcription)**\n\nDefault: `null`\n\n"},"realtime_endpoints":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointRequest"},"default":[],"description":"Add endpoints here to receive data (e.g transcript, participant events) from the recording in realtime during the meeting.\n\nDefault: `[]`\n\n"},"retention":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetentionRequest"}],"nullable":true,"description":"Specify the retention policy for the recording. **[Read more in this guide](https://docs.recall.ai/docs/storage-and-playback)**"},"video_mixed_layout":{"allOf":[{"$ref":"#/components/schemas/VideoMixedLayoutEnum"}],"default":"speaker_view","description":"The layout of the mixed video output.\n\n* `speaker_view` - speaker_view\n* `gallery_view` - gallery_view\n* `gallery_view_v2` - gallery_view_v2\n* `audio_only` - audio_only"},"video_mixed_mp4":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Capture mixed video of the meeting as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"participant_events":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"default":{},"description":"Capture participant events as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"meeting_metadata":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"default":{},"description":"Capture meeting metadata as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"video_mixed_participant_video_when_screenshare":{"allOf":[{"$ref":"#/components/schemas/VideoMixedParticipantVideoWhenScreenshareEnum"}],"default":"overlap","description":"The layout of participant video streams in mixed video output when screen is being shared. More docs: https://docs.recall.ai/docs/video-layouts\n\n* `hide` - hide\n* `beside` - beside\n* `overlap` - overlap"},"start_recording_on":{"allOf":[{"$ref":"#/components/schemas/StartRecordingOnEnum"}],"default":"participant_join","description":"Specify when automatic recording should start.\n*call_join* - Bot will start recording as soon as it joins the call.\n*participant_join* - Bot will start recording when the first participant joins the call. If a participant is already present when the bot joins, the bot will automatically start recording.\n*participant_speak* - Bot will start recording when the first participant starts talking.\n\n\n* `call_join` - call_join\n* `participant_join` - participant_join\n* `participant_speak` - participant_speak"},"include_bot_in_recording":{"$ref":"#/components/schemas/BotIncludeInRecordingRequest"},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"audio_mixed_raw":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture mixed audio in raw format of the meeting.\n\nDefault: `null`\n\n"},"audio_mixed_mp3":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture mixed audio in the mp3 format of the meeting\n\nDefault: `null`\n\n"},"video_separate_mp4":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture separate video in mp4 format for each participant in the meeting. Only supported with video_mixed_layout='gallery_view_v2'. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-videos-per-participant-async)**\n\nDefault: `null`\n\n"},"audio_separate_raw":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture separate audio in raw format for each participant in the meeting(**limited support**).  **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-audio-per-participant-async)**\n\nDefault: `null`\n\n"},"audio_separate_mp3":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture separate audio in mp3 format for each participant in the meeting. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-audio-per-participant-async)**\n\nDefault: `null`\n\n"},"video_mixed_flv":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture mixed video in flv format(**required for rtmp streaming). \n\nDefault: `null`\n\n"},"video_separate_png":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture separate video in png format for each participant in the meeting. Only supported with video_mixed_layout='gallery_view_v2'. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-videos-per-participant-realtime)**\n\nDefault: `null`\n\n"},"video_separate_h264":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture separate video in compressed h264 for each participant in the meeting. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-videos-per-participant-realtime)**\n\nDefault: `null`\n\n"}}},"BotRecordingConfigRetention":{"type":"object","properties":{"type":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetentionSharedTypeEnum"}],"description":"The type of the retention policy.\n\n* `timed` - Timed\n* `forever` - Forever"},"hours":{"type":"integer","minimum":1,"default":168,"description":"The number of hours to retain the recording."}},"required":["type"]},"BotRecordingConfigRetentionBotRecordingConfigRetentionForever":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetentionShared"},{"$ref":"#/components/schemas/BotRecordingConfigRetentionForever"}]},"BotRecordingConfigRetentionBotRecordingConfigRetentionForeverRequest":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetentionShared"},{"$ref":"#/components/schemas/BotRecordingConfigRetentionForeverRequest"}]},"BotRecordingConfigRetentionBotRecordingConfigRetentionTimed":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetentionShared"},{"$ref":"#/components/schemas/BotRecordingConfigRetentionTimed"}]},"BotRecordingConfigRetentionBotRecordingConfigRetentionTimedRequest":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetentionShared"},{"$ref":"#/components/schemas/BotRecordingConfigRetentionTimedRequest"}]},"BotRecordingConfigRetentionForever":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/BotRecordingConfigRetentionForeverTypeEnum"}},"required":["type"]},"BotRecordingConfigRetentionForeverRequest":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/BotRecordingConfigRetentionForeverTypeEnum"}},"required":["type"]},"BotRecordingConfigRetentionForeverTypeEnum":{"enum":["forever"],"type":"string","description":"* `forever` - forever"},"BotRecordingConfigRetentionRequest":{"type":"object","properties":{"type":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetentionSharedTypeEnum"}],"description":"The type of the retention policy.\n\n* `timed` - Timed\n* `forever` - Forever"},"hours":{"type":"integer","minimum":1,"default":168,"description":"The number of hours to retain the recording."}},"required":["type"]},"BotRecordingConfigRetentionShared":{"type":"object","properties":{"type":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetentionSharedTypeEnum"}],"description":"The type of the retention policy.\n\n* `timed` - Timed\n* `forever` - Forever"}},"required":["type"]},"BotRecordingConfigRetentionSharedTypeEnum":{"enum":["timed","forever"],"type":"string","description":"* `timed` - Timed\n* `forever` - Forever"},"BotRecordingConfigRetentionTimed":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/BotRecordingConfigRetentionTimedTypeEnum"},"hours":{"type":"integer","minimum":1,"default":168,"description":"The number of hours to retain the recording."}},"required":["type"]},"BotRecordingConfigRetentionTimedRequest":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/BotRecordingConfigRetentionTimedTypeEnum"},"hours":{"type":"integer","minimum":1,"default":168,"description":"The number of hours to retain the recording."}},"required":["type"]},"BotRecordingConfigRetentionTimedTypeEnum":{"enum":["timed"],"type":"string","description":"* `timed` - timed"},"BotRecordingConfigTranscriptArtifact":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}},"provider":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigTranscriptProvider"}],"title":"Transcription Provider","description":"The **[transcription method](https://docs.recall.ai//docs/bot-transcription)** to get the transcript of the meeting."},"diarization":{"$ref":"#/components/schemas/BotRecordingConfigTranscriptDiarization"}},"required":["provider"]},"BotRecordingConfigTranscriptArtifactRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}},"provider":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigTranscriptProviderRequest"}],"title":"Transcription Provider","description":"The **[transcription method](https://docs.recall.ai//docs/bot-transcription)** to get the transcript of the meeting."},"diarization":{"$ref":"#/components/schemas/BotRecordingConfigTranscriptDiarizationRequest"}},"required":["provider"]},"BotRecordingConfigTranscriptDiarization":{"type":"object","properties":{"use_separate_streams_when_available":{"type":"boolean","description":"Use separate audio streams(a.k.a perfect diarization) when available. This feature has limted support. **[Read more in this guide](https://docs.recall.ai/docs/perfect-diarization)**"}}},"BotRecordingConfigTranscriptDiarizationRequest":{"type":"object","properties":{"use_separate_streams_when_available":{"type":"boolean","description":"Use separate audio streams(a.k.a perfect diarization) when available. This feature has limted support. **[Read more in this guide](https://docs.recall.ai/docs/perfect-diarization)**"}}},"BotRecordingConfigTranscriptProvider":{"type":"object","properties":{"recallai_streaming":{"allOf":[{"$ref":"#/components/schemas/RecallaiStreamingTranscription"}],"title":"RecallAI Real-time Transcription Settings","description":" **[Read more in this guide](https://docs.recall.ai/docs/recallai-transcription)**"},"assembly_ai_async_chunked":{"properties":{"audio_end_at":{"x-label":"Audio end at","description":"The point in time, in milliseconds, to stop transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer"},"audio_start_from":{"x-label":"Audio start from","description":"The point in time, in milliseconds, to begin transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer"},"auto_chapters":{"x-label":"Auto chapters","description":"Enable [Auto Chapters](https://www.assemblyai.com/docs/speech-understanding/auto-chapters), can be true or false","type":"boolean","default":false},"auto_highlights":{"x-label":"Key phrases","description":"Enable [Key Phrases](https://www.assemblyai.com/docs/speech-understanding/key-phrases), either true or false","type":"boolean","default":false},"content_safety":{"x-label":"Content Moderation","description":"Enable [Content Moderation](https://www.assemblyai.com/docs/content-moderation), can be true or false","type":"boolean","default":false},"content_safety_confidence":{"x-label":"Content Moderation confidence","description":"The confidence threshold for the [Content Moderation](https://www.assemblyai.com/docs/content-moderation) model. Values must be between 25 and 100.","type":"integer","default":50,"minimum":25,"maximum":100},"custom_spelling":{"x-label":"Custom spellings","description":"Customize how words are spelled and formatted using to and from values. See [Custom Spelling](https://www.assemblyai.com/docs/pre-recorded-audio/custom-spelling) for more details.","type":"array","items":{"x-label":"Custom spelling","description":"Object containing words or phrases to replace, and the word or phrase to replace with","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"from":{"x-label":"From","description":"Words or phrases to replace","type":"array","items":{"x-label":"Word or phrase","description":"Word or phrase to replace","type":"string"}},"to":{"x-label":"To","description":"Word to replace with","type":"string"}},"required":["from","to"],"example":{"from":["dicarlo"],"to":"Decarlo"}}},"disfluencies":{"x-label":"Disfluencies","description":"Transcribe [Filler Words](https://www.assemblyai.com/docs/pre-recorded-audio/filler-words), like \"umm\", in your media file; can be true or false","type":"boolean","default":false},"entity_detection":{"x-label":"Entity Detection","description":"Enable [Entity Detection](https://www.assemblyai.com/docs/speech-understanding/entity-detection), can be true or false","type":"boolean","default":false},"filter_profanity":{"x-label":"Filter profanity","description":"Filter profanity from the transcribed text, can be true or false. See [Profanity Filtering](https://www.assemblyai.com/docs/profanity-filtering) for more details.","type":"boolean","default":false},"format_text":{"x-label":"Format text","description":"Enable [Text Formatting](https://www.assemblyai.com/docs/pre-recorded-audio), can be true or false","type":"boolean","default":true},"iab_categories":{"x-label":"Topic Detection","description":"Enable [Topic Detection](https://www.assemblyai.com/docs/speech-understanding/topic-detection), can be true or false","type":"boolean","default":false},"keyterms_prompt":{"x-label":"Keyterms prompt","description":"Improve accuracy with up to 200 (for Universal-2) or 1000 (for Universal-3-Pro) domain-specific words or phrases (maximum 6 words per phrase). See [Keyterms Prompting](https://www.assemblyai.com/docs/pre-recorded-audio/keyterms-prompting) for more details.\n","type":"array","items":{"x-label":"Keyterm","type":"string"}},"language_code":{"x-label":"Language code","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","oneOf":[{"anyOf":[{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"}}},{"type":"string"}]},{"type":"string","nullable":true}],"default":"en_us","x-ts-type":"LiteralUnion<TranscriptLanguageCode, string> | null","x-go-type":"TranscriptLanguageCode"},"language_codes":{"description":"The language codes of your audio file. Used for [Code switching](/docs/speech-to-text/pre-recorded-audio/code-switching)\nOne of the values specified must be `en`.\n","type":"array","items":{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"}}},"nullable":true},"language_confidence_threshold":{"x-label":"Language confidence threshold","description":"The confidence threshold for the automatically detected language.\nAn error will be returned if the language confidence is below this threshold.\nDefaults to 0. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0},"language_detection":{"x-label":"Language detection","description":"Enable [Automatic language detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection), either true or false.","type":"boolean","default":false},"language_detection_options":{"x-label":"Specify options for Automatic Language Detection.","description":"Specify options for [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection).","type":"object","additionalProperties":false,"properties":{"expected_languages":{"x-label":"Expected languages","description":"List of languages expected in the audio file. Defaults to `[\"all\"]` when unspecified. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.","type":"array","items":{"x-label":"language","type":"string"}},"fallback_language":{"x-label":"Fallback language","description":"If the detected language of the audio file is not in the list of expected languages, the `fallback_language` is used. Specify `[\"auto\"]` to let our model choose the fallback language from `expected_languages` with the highest confidence score. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"string","default":"auto"},"code_switching":{"x-label":"Code switching","description":"Whether [code switching](/docs/speech-to-text/pre-recorded-audio/code-switching) should be detected.\n","type":"boolean","default":false},"code_switching_confidence_threshold":{"x-label":"Code switching confidence threshold","description":"The confidence threshold for [code switching](/docs/speech-to-text/pre-recorded-audio/code-switching) detection. If the code switching confidence is below this threshold, the transcript will be processed in the language with the highest `language_detection_confidence` score.\n","type":"number","minimum":0,"maximum":1,"default":0.3}}},"multichannel":{"x-label":"Multichannel","description":"Enable [Multichannel](https://www.assemblyai.com/docs/pre-recorded-audio/multichannel) transcription, can be true or false.","type":"boolean","default":false},"prompt":{"x-label":"Prompt","description":"Provide natural language prompting of up to 1,500 words of contextual information to the model. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for best practices.\n\nNote: This parameter is only supported for the Universal-3-Pro model.\n","type":"string"},"punctuate":{"x-label":"Punctuate","description":"Enable [Automatic Punctuation](https://www.assemblyai.com/docs/pre-recorded-audio), can be true or false","type":"boolean","default":true},"redact_pii":{"x-label":"Redact PII","description":"Redact PII from the transcribed text using the Redact PII model, can be true or false. See [PII Redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"boolean","default":false},"redact_pii_audio":{"x-label":"Redact PII audio","description":"Generate a copy of the original media file with spoken PII \"beeped\" out, can be true or false. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","type":"boolean","default":false},"redact_pii_audio_options":{"x-label":"Specify options for PII redacted audio files.","description":"Specify options for [PII redacted audio](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) files.","type":"object","additionalProperties":false,"properties":{"return_redacted_no_speech_audio":{"x-label":"Return redacted no speech audio","description":"By default, audio redaction provides redacted audio URLs only when speech is detected. However, if your use-case specifically requires redacted audio files even for silent audio files without any dialogue, you can opt to receive these URLs by setting this parameter to `true`.","type":"boolean","default":false}}},"redact_pii_audio_quality":{"x-label":"Redact PII audio quality","type":"string","description":"Controls the filetype of the audio created by redact_pii_audio. Currently supports mp3 (default) and wav. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","x-fern-sdk-group-name":"transcripts","enum":["mp3","wav"],"x-fern-enum":{"mp3":{"description":"MP3 audio format is lower quality and lower size than WAV.","casing":{"camel":"mp3","snake":"mp3","pascal":"Mp3","screamingSnake":"MP3"}},"wav":{"description":"WAV audio format is the highest quality (no compression) and larger size than MP3."}},"x-aai-enum":{"mp3":{"label":"MP3"},"wav":{"label":"WAV"}},"example":"mp3"},"redact_pii_policies":{"x-label":"Redact PII policies","description":"The list of PII Redaction policies to enable. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"array","items":{"x-label":"PII policy","description":"The type of PII to redact","x-fern-sdk-group-name":"transcripts","type":"string","enum":["account_number","banking_information","blood_type","credit_card_cvv","credit_card_expiration","credit_card_number","date","date_interval","date_of_birth","drivers_license","drug","duration","email_address","event","filename","gender_sexuality","healthcare_number","injury","ip_address","language","location","marital_status","medical_condition","medical_process","money_amount","nationality","number_sequence","occupation","organization","passport_number","password","person_age","person_name","phone_number","physical_attribute","political_affiliation","religion","statistics","time","url","us_social_security_number","username","vehicle_id","zodiac_sign"],"x-fern-enum":{"account_number":{"description":"Customer account or membership identification number (e.g., Policy No. 10042992, Member ID: HZ-5235-001)"},"banking_information":{"description":"Banking information, including account and routing numbers"},"blood_type":{"description":"Blood type (e.g., O-, AB positive)"},"credit_card_cvv":{"description":"Credit card verification code (e.g., CVV: 080)"},"credit_card_expiration":{"description":"Expiration date of a credit card"},"credit_card_number":{"description":"Credit card number"},"date":{"description":"Specific calendar date (e.g., December 18)"},"date_interval":{"description":"Broader time periods, including date ranges, months, seasons, years, and decades (e.g., 2020-2021, 5-9 May, January 1984)"},"date_of_birth":{"description":"Date of birth (e.g., Date of Birth: March 7,1961)"},"drivers_license":{"description":"Driver's license number. (e.g., DL# 356933-540)"},"drug":{"description":"Medications, vitamins, or supplements (e.g., Advil, Acetaminophen, Panadol)"},"duration":{"description":"Periods of time, specified as a number and a unit of time (e.g., 8 months, 2 years)"},"email_address":{"description":"Email address (e.g., support@assemblyai.com)"},"event":{"description":"Name of an event or holiday (e.g., Olympics, Yom Kippur)"},"filename":{"description":"Names of computer files, including the extension or filepath (e.g., Taxes/2012/brad-tax-returns.pdf)"},"gender_sexuality":{"description":"Terms indicating gender identity or sexual orientation, including slang terms (e.g., female, bisexual, trans)"},"healthcare_number":{"description":"Healthcare numbers and health plan beneficiary numbers (e.g., Policy No.: 5584-486-674-YM)"},"injury":{"description":"Bodily injury (e.g., I broke my arm, I have a sprained wrist)"},"ip_address":{"description":"Internet IP address, including IPv4 and IPv6 formats (e.g., 192.168.0.1)"},"language":{"description":"Name of a natural language (e.g., Spanish, French)"},"location":{"description":"Any Location reference including mailing address, postal code, city, state, province, country, or coordinates. (e.g., Lake Victoria, 145 Windsor St., 90210)"},"marital_status":{"description":"Terms indicating marital status (e.g., Single, common-law, ex-wife, married)"},"medical_condition":{"description":"Name of a medical condition, disease, syndrome, deficit, or disorder (e.g., chronic fatigue syndrome, arrhythmia, depression)"},"medical_process":{"description":"Medical process, including treatments, procedures, and tests (e.g., heart surgery, CT scan)"},"money_amount":{"description":"Name and/or amount of currency (e.g., 15 pesos, $94.50)"},"nationality":{"description":"Terms indicating nationality, ethnicity, or race (e.g., American, Asian, Caucasian)"},"number_sequence":{"description":"Numerical PII (including alphanumeric strings) that doesn't fall under other categories"},"occupation":{"description":"Job title or profession (e.g., professor, actors, engineer, CPA)"},"organization":{"description":"Name of an organization (e.g., CNN, McDonalds, University of Alaska, Northwest General Hospital)"},"passport_number":{"description":"Passport numbers, issued by any country (e.g., PA4568332, NU3C6L86S12)"},"password":{"description":"Account passwords, PINs, access keys, or verification answers (e.g., 27%alfalfa, temp1234, My mother's maiden name is Smith)"},"person_age":{"description":"Number associated with an age (e.g., 27, 75)"},"person_name":{"description":"Name of a person (e.g., Bob, Doug Jones, Dr. Kay Martinez, MD)"},"phone_number":{"description":"Telephone or fax number"},"physical_attribute":{"description":"Distinctive bodily attributes, including terms indicating race (e.g., I'm 190cm tall, He belongs to the Black students' association)"},"political_affiliation":{"description":"Terms referring to a political party, movement, or ideology (e.g., Republican, Liberal)"},"religion":{"description":"Terms indicating religious affiliation (e.g., Hindu, Catholic)"},"statistics":{"description":"Medical statistics (e.g., 18%, 18 percent)"},"time":{"description":"Expressions indicating clock times (e.g., 19:37:28, 10pm EST)"},"url":{"description":"Internet addresses (e.g., https://www.assemblyai.com/)"},"us_social_security_number":{"description":"Social Security Number or equivalent"},"username":{"description":"Usernames, login names, or handles (e.g., @AssemblyAI)"},"vehicle_id":{"description":"Vehicle identification numbers (VINs), vehicle serial numbers, and license plate numbers (e.g., 5FNRL38918B111818, BIF7547)"},"zodiac_sign":{"description":"Names of Zodiac signs (e.g., Aries, Taurus)"}},"x-aai-enum":{"account_number":{"label":"Account number"},"banking_information":{"label":"Banking information"},"blood_type":{"label":"Blood type"},"credit_card_cvv":{"label":"Credit card CVV"},"credit_card_expiration":{"label":"Credit card expiration"},"credit_card_number":{"label":"Credit card number"},"date":{"label":"Date"},"date_interval":{"label":"Date interval"},"date_of_birth":{"label":"Date of birth"},"drivers_license":{"label":"Driver's license"},"drug":{"label":"Drug"},"duration":{"label":"Duration"},"email_address":{"label":"Email address"},"event":{"label":"Event"},"filename":{"label":"Filename"},"gender_sexuality":{"label":"Gender sexuality"},"healthcare_number":{"label":"Healthcare number"},"injury":{"label":"Injury"},"ip_address":{"label":"IP address"},"language":{"label":"Language"},"location":{"label":"Location"},"marital_status":{"label":"Marital status"},"medical_condition":{"label":"Medical condition"},"medical_process":{"label":"Medical process"},"money_amount":{"label":"Money amount"},"nationality":{"label":"Nationality"},"number_sequence":{"label":"Number sequence"},"occupation":{"label":"Occupation"},"organization":{"label":"Organization"},"passport_number":{"label":"Passport number"},"password":{"label":"Password"},"person_age":{"label":"Person age"},"person_name":{"label":"Person name"},"phone_number":{"label":"Phone number"},"physical_attribute":{"label":"Physical attribute"},"political_affiliation":{"label":"Political affiliation"},"religion":{"label":"Religion"},"statistics":{"label":"Statistics"},"time":{"label":"Time"},"url":{"label":"URL"},"us_social_security_number":{"label":"US Social Security Number"},"username":{"label":"Username"},"vehicle_id":{"label":"Vehicle ID"},"zodiac_sign":{"label":"Zodiac sign"}}}},"redact_pii_sub":{"x-label":"Redact PII substitution","description":"The replacement logic for detected PII, can be `entity_type` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","oneOf":[{"x-label":"Redact PII substitution","type":"string","x-fern-sdk-group-name":"transcripts","description":"The replacement logic for detected PII, can be `entity_name` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","enum":["entity_name","hash"],"x-aai-enum":{"entity_name":{"label":"Entity name"},"hash":{"label":"Hash"}}},{"type":"string","nullable":true}],"default":"hash"},"sentiment_analysis":{"x-label":"Sentiment Analysis","description":"Enable [Sentiment Analysis](https://www.assemblyai.com/docs/speech-understanding/sentiment-analysis), can be true or false","type":"boolean","default":false},"speaker_labels":{"x-label":"Speaker labels","description":"Enable [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization), can be true or false","type":"boolean","default":false},"speaker_options":{"x-label":"Specify options for speaker diarization.","description":"Specify options for [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers). Use this to set a range of possible speakers.","type":"object","additionalProperties":false,"properties":{"min_speakers_expected":{"x-label":"Minimum speakers expected","description":"The minimum number of speakers expected in the audio file. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers) for more details.","type":"integer","default":1},"max_speakers_expected":{"x-label":"Maximum speakers expected","description":"<Warning>Setting this parameter too high may hurt model accuracy</Warning>\nThe maximum number of speakers expected in the audio file. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers) for more details.\n","type":"integer","default":10}}},"speakers_expected":{"x-label":"Speakers expected","description":"Tells the speaker label model how many speakers it should attempt to identify. See [Set number of speakers expected](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-number-of-speakers-expected) for more details.","type":"integer","default":null,"nullable":true},"speech_models":{"x-label":"Speech models","description":"List multiple speech models in priority order, allowing our system to automatically route your audio to the best available option. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models and routing behavior.\n","type":"array","items":{"x-label":"Speech model","type":"string","description":"The speech model to use for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","x-fern-sdk-group-name":"transcripts"}},"speech_threshold":{"x-label":"Speech threshold","description":"Reject audio files that contain less than this fraction of speech.\nValid values are in the range [0, 1] inclusive. See [Speech Threshold](https://www.assemblyai.com/docs/speech-threshold) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0,"nullable":true},"speech_understanding":{"x-label":"Speech Understanding","description":"Enable speech understanding tasks like [Translation](https://www.assemblyai.com/docs/speech-understanding/translation), [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification), and [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting). See the task-specific docs for available options and configuration.\n","type":"object","properties":{"request":{"oneOf":[{"x-label":"Translation request body","description":"Request body for [Translation](https://www.assemblyai.com/docs/speech-understanding/translation).","type":"object","properties":{"translation":{"type":"object","properties":{"target_languages":{"type":"array","items":{"type":"string"},"description":"List of target language codes (e.g., `[\"es\", \"de\"]`). See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for supported languages."},"formal":{"type":"boolean","description":"Use formal language style. See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for more details.","default":true},"match_original_utterance":{"type":"boolean","description":"When enabled with Speaker Labels, returns translated text in the utterances array. Each utterance will include a `translated_texts` key containing translations for each target language.","default":false}},"required":["target_languages"]}},"required":["translation"]},{"type":"object","description":"Request body for [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification).","properties":{"speaker_identification":{"type":"object","properties":{"speaker_type":{"type":"string","enum":["role","name"],"description":"Type of speaker identification. See [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification) for details on each type."},"known_values":{"type":"array","items":{"type":"string"},"description":"Required if speaker_type is \"role\". Each value must be 35 characters or less."},"speakers":{"type":"array","description":"An array of speaker objects with metadata to improve identification accuracy. Each object should include a `role` or `name` (depending on `speaker_type`) and an optional `description` to help the model identify the speaker. You can also include any additional custom properties (e.g., `company`, `title`) to provide more context. Use this as an alternative to `known_values` when you want to provide additional context about each speaker.","items":{"type":"object","properties":{"role":{"type":"string","description":"The role of the speaker. Required when `speaker_type` is \"role\"."},"name":{"type":"string","description":"The name of the speaker. Required when `speaker_type` is \"name\"."},"description":{"type":"string","description":"A description of the speaker to help the model identify them based on conversational context."}},"additionalProperties":true}}},"required":["speaker_type"]}},"required":["speaker_identification"]},{"type":"object","description":"Request body for [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting).","properties":{"custom_formatting":{"type":"object","properties":{"date":{"type":"string","description":"Date format pattern (e.g., `\"mm/dd/yyyy\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."},"phone_number":{"type":"string","description":"Phone number format pattern (e.g., `\"(xxx)xxx-xxxx\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."},"email":{"type":"string","description":"Email format pattern (e.g., `\"username@domain.com\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."}}}},"required":["custom_formatting"]}]}},"required":["request"]},"summarization":{"x-label":"Enable Summarization","description":"Enable [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization), can be true or false","type":"boolean","default":false},"summary_model":{"type":"string","x-label":"Summary model","description":"The model to summarize the transcript","x-fern-sdk-group-name":"transcripts","enum":["informative","conversational","catchy"],"x-aai-enum":{"informative":{"label":"Informative"},"conversational":{"label":"Conversational"},"catchy":{"label":"Catchy"}}},"summary_type":{"type":"string","x-label":"Summary type","description":"The type of summary","x-fern-sdk-group-name":"transcripts","enum":["bullets","bullets_verbose","gist","headline","paragraph"],"x-aai-enum":{"bullets":{"label":"Bullets"},"bullets_verbose":{"label":"Bullets verbose"},"gist":{"label":"Gist"},"headline":{"label":"Headline"},"paragraph":{"label":"Paragraph"}}},"temperature":{"x-label":"Temperature","description":"Control the amount of randomness injected into the model's response. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for more details.\n\nNote: This parameter can only be used with the Universal-3-Pro model.\n","type":"number","minimum":0,"maximum":1,"default":0},"custom_topics":{"x-label":"Enable custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"boolean","default":false,"deprecated":true},"speech_model":{"x-label":"Speech model","description":"This parameter has been replaced with the `speech_models` parameter, learn more about the `speech_models` parameter [here](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model).\n","oneOf":[{"x-label":"Speech model","type":"string","description":"The speech model to use for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","x-fern-sdk-group-name":"transcripts"},{"type":"string","nullable":true}],"deprecated":true},"topics":{"x-label":"Custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"array","items":{"x-label":"Topic","type":"string"},"deprecated":true}},"type":"object","additionalProperties":false,"x-label":"Optional transcript parameters","description":"Docs: https://www.assemblyai.com/docs/api-reference/transcripts/submit","x-fern-sdk-group-name":"transcripts","example":{"speech_model":null,"language_code":"en_us","language_detection":true,"language_confidence_threshold":0.7,"punctuate":true,"format_text":true,"multichannel":true,"webhook_url":"https://your-webhook-url.tld/path","webhook_auth_header_name":"webhook-secret","webhook_auth_header_value":"webhook-secret-value","auto_highlights":true,"audio_start_from":10,"audio_end_at":280,"filter_profanity":true,"redact_pii":true,"redact_pii_audio":true,"redact_pii_audio_quality":"mp3","redact_pii_policies":["us_social_security_number","credit_card_number"],"redact_pii_sub":"hash","speaker_labels":true,"speakers_expected":2,"content_safety":true,"iab_categories":true,"custom_spelling":[],"disfluencies":false,"sentiment_analysis":true,"auto_chapters":true,"entity_detection":true,"speech_threshold":0.5,"summarization":true,"summary_model":"informative","summary_type":"bullets","custom_topics":true,"topics":[],"speech_understanding":{"request":{"translation":{"target_languages":["es","de"],"formal":true,"match_original_utterance":true}}}},"title":"AssemblyAi async chunked transcription Settings"},"assembly_ai_v3_streaming":{"type":"object","properties":{"speech_model":{"description":"The speech model used for your Streaming session.","enum":["universal-streaming-english","universal-streaming-multilingual","whisper-rt","u3-rt-pro"]},"format_turns":{"description":"Whether to return formatted final transcripts.","default":false,"type":"boolean"},"inactivity_timeout":{"description":"Optional time in seconds of inactivity before session is terminated. If not set, no inactivity timeout is applied.","default":"None","format":"s","type":"integer","minimum":5,"maximum":3600},"keyterms_prompt":{"description":"A list of words and phrases to improve recognition accuracy for. See [Keyterms Prompting](https://www.assemblyai.com/docs/streaming/keyterms-prompting) for more details.","type":"array","items":{"x-label":"Word","type":"string"}},"language_detection":{"description":"Whether to detect the language and return language metadata on utterances and final turns. Only available for the multilingual model.","enum":["true","false"],"default":"false"},"max_turn_silence":{"description":"The maximum amount of silence in milliseconds allowed in a turn before end of turn is triggered. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","type":"integer","default":1280},"min_turn_silence":{"description":"The minimum amount of silence in milliseconds required to detect end of turn when confident. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","type":"integer","default":400},"vad_threshold":{"description":"The confidence threshold (0.0 to 1.0) for classifying audio frames as silence. Frames with VAD confidence below this value are considered silent. Increase for noisy environments to reduce false speech detection.","default":0.4,"type":"number"},"end_of_turn_confidence_threshold":{"description":"The confidence threshold (0.0 to 1.0) to use when determining if the end of a turn has been reached. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","deprecated":true,"type":"number","default":0.4},"language":{"description":"The language of your audio stream.","enum":["en","multi"],"default":"en","deprecated":true}},"title":"AssemblyAi Real-time Transcription Settings","description":"Docs: https://www.assemblyai.com/docs/api-reference/streaming-api/streaming-api"},"deepgram_streaming":{"type":"object","properties":{"diarize":{"description":"Defaults to `false`. Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0","default":"false","enum":["true","false"]},"dictation":{"description":"Identify and extract key entities from content in submitted audio","default":"false","enum":["true","false"]},"endpointing":{"description":"Indicates how long Deepgram will wait to detect whether a speaker has finished speaking or pauses for a significant period of time. When set to a value, the streaming endpoint immediately finalizes the transcription for the processed time range and returns the transcript with a speech_final parameter set to true. Can also be set to false to disable endpointing","default":"10"},"extra":{"description":"Arbitrary key-value pairs that are attached to the API response for usage in downstream processing"},"filler_words":{"description":"Filler Words can help transcribe interruptions in your audio, like \"uh\" and \"um\"","default":"false","enum":["true","false"]},"interim_results":{"description":"Specifies whether the streaming endpoint should provide ongoing transcription updates as more audio is received. When set to true, the endpoint sends continuous updates, meaning transcription results may evolve over time","default":"false","enum":["true","false"]},"keyterm":{"description":"Key term prompting can boost or suppress specialized terminology and brands. Only compatible with Nova-3"},"keywords":{"description":"Keywords can boost or suppress specialized terminology and brands"},"language":{"description":"The [BCP-47 language tag](https://tools.ietf.org/html/bcp47) that hints at the primary spoken language. Depending on the Model you choose only certain languages are available","default":"en","enum":["bg","ca","cs","da","da-DK","de","de-CH","el","en","en-AU","en-GB","en-IN","en-NZ","en-US","es","es-419","es-LATAM","et","fi","fr","fr-CA","hi","hi-Latn","hu","id","it","ja","ko","ko-KR","lt","lv","ms","multi","nl","nl-BE","no","pl","pt","pt-BR","pt-PT","ro","ru","sk","sv","sv-SE","taq","th","th-TH","tr","uk","vi","zh","zh-CN","zh-HK","zh-Hans","zh-Hant","zh-TW"]},"mip_opt_out":{"description":"Opts out requests from the Deepgram Model Improvement Program. Refer to our Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mip","default":"false"},"model":{"description":"AI model to use for the transcription","enum":["nova-3","nova-3-general","nova-3-medical","nova-2","nova-2-general","nova-2-meeting","nova-2-finance","nova-2-conversationalai","nova-2-voicemail","nova-2-video","nova-2-medical","nova-2-drivethru","nova-2-automotive","nova","nova-general","nova-phonecall","nova-medical","enhanced","enhanced-general","enhanced-meeting","enhanced-phonecall","enhanced-finance","base","meeting","phonecall","finance","conversationalai","voicemail","video","custom"]},"multichannel":{"description":"Transcribe each audio channel independently","default":"false","enum":["true","false"]},"numerals":{"description":"Convert numbers from written format to numerical format","default":"false","enum":["true","false"]},"profanity_filter":{"description":"Profanity Filter looks for recognized profanity and converts it to the nearest recognized non-profane word or removes it from the transcript completely","default":"false","enum":["true","false"]},"punctuate":{"description":"Add punctuation and capitalization to the transcript","default":"false","enum":["true","false"]},"redact":{"description":"Redaction removes sensitive information from your transcripts","default":"false","enum":["true","false","pci","numbers","aggressive_numbers","ssn"]},"replace":{"description":"Search for terms or phrases in submitted audio and replaces them"},"search":{"description":"Search for terms or phrases in submitted audio"},"smart_format":{"description":"Apply formatting to transcript output. When set to true, additional formatting will be applied to transcripts to improve readability","default":"false","enum":["true","false"]},"tag":{"description":"Label your requests for the purpose of identification during usage reporting"},"utterance_end_ms":{"description":"Indicates how long Deepgram will wait to send an UtteranceEnd message after a word has been transcribed. Use with interim_results"},"vad_events":{"description":"Indicates that speech has started. You'll begin receiving Speech Started messages upon speech starting","default":"false","enum":["true","false"]},"version":{"description":"Version of an AI model to use","default":"latest"}},"title":"Deepgram Real-time Transcription Settings","description":"Docs: https://developers.deepgram.com/reference/streaming"},"gladia_v2_streaming":{"type":"object","properties":{"custom_metadata":{"type":"object","description":"Custom metadata you can attach to this live transcription","example":{"user":"John Doe"}},"model":{"type":"string","description":"The model used to process the audio. \"solaria-1\" is used by default.","default":"solaria-1","enum":["solaria-1"]},"endpointing":{"type":"number","description":"The endpointing duration in seconds. Endpointing is the duration of silence which will cause an utterance to be considered as finished","default":0.05,"minimum":0.01,"maximum":10},"maximum_duration_without_endpointing":{"type":"number","description":"The maximum duration in seconds without endpointing. If endpointing is not detected after this duration, current utterance will be considered as finished","default":5,"minimum":5,"maximum":60},"language_config":{"properties":{"languages":{"type":"array","description":"If one language is set, it will be used for the transcription. Otherwise, language will be auto-detected by the model.","default":[],"items":{"type":"string","enum":["af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","ca","zh","hr","cs","da","nl","en","et","fo","fi","fr","gl","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","id","it","ja","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","mymr","ne","no","nn","oc","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","jp"]}},"code_switching":{"type":"boolean","description":"If true, language will be auto-detected on each utterance. Otherwise, language will be auto-detected on first utterance and then used for the rest of the transcription. If one language is set, this option will be ignored.","default":false}},"type":"object","description":"Specify the language configuration"},"pre_processing":{"properties":{"audio_enhancer":{"type":"boolean","description":"If true, apply pre-processing to the audio stream to enhance the quality.","default":false},"speech_threshold":{"type":"number","description":"Sensitivity configuration for Speech Threshold. A value close to 1 will apply stricter thresholds, making it less likely to detect background sounds as speech.","default":0.6,"minimum":0,"maximum":1}},"type":"object","description":"Specify the pre-processing configuration"},"realtime_processing":{"properties":{"custom_vocabulary":{"type":"boolean","description":"If true, enable custom vocabulary for the transcription.","default":false},"custom_vocabulary_config":{"properties":{"vocabulary":{"description":"Specific vocabulary list to feed the transcription model with. Each item can be a string or an object with the following properties: value, intensity, pronunciations, language.","example":["Westeros",{"value":"Stark"},{"value":"Night's Watch","pronunciations":["Nightz Watch"],"intensity":0.4,"language":"en"}],"type":"array","items":{"oneOf":[{"type":"object","properties":{"value":{"type":"string","description":"The text used to replace in the transcription.","example":"Gladia"},"intensity":{"type":"number","description":"The global intensity of the feature.","example":0.5,"minimum":0,"maximum":1},"pronunciations":{"description":"The pronunciations used in the transcription.","type":"array","items":{"type":"string"}},"language":{"type":"string","description":"Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.","example":"en"}},"required":["value"]},{"type":"string"}]}},"default_intensity":{"type":"number","description":"Default intensity for the custom vocabulary","example":0.5,"minimum":0,"maximum":1}},"required":["vocabulary"],"type":"object","description":"Custom vocabulary configuration, if `custom_vocabulary` is enabled"},"custom_spelling":{"type":"boolean","description":"If true, enable custom spelling for the transcription.","default":false},"custom_spelling_config":{"properties":{"spelling_dictionary":{"type":"object","description":"The list of spelling applied on the audio transcription","example":{"Gettleman":["gettleman"],"SQL":["Sequel"]}}},"required":["spelling_dictionary"],"type":"object","description":"Custom spelling configuration, if `custom_spelling` is enabled"},"translation":{"type":"boolean","description":"If true, enable translation for the transcription","default":false},"translation_config":{"properties":{"target_languages":{"type":"array","example":["en"],"minItems":1,"items":{"type":"string","description":"The target language in `iso639-1` format","enum":["af","sq","am","ar","hy","as","ast","az","ba","eu","be","bn","bs","br","bg","my","ca","ceb","zh","hr","cs","da","nl","en","et","fo","fi","nl","fr","fy","ff","gd","gl","lg","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","ig","ilo","id","ga","it","ja","jp","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mo","mn","mymr","ne","no","nn","oc","or","pa","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","ss","sv","tl","tg","ta","tt","te","th","bo","tn","tr","tk","uk","ur","uz","vi","cy","wo","xh","yi","yo","zu"]}},"model":{"type":"string","description":"Model you want the translation model to use to translate","default":"base","enum":["base","enhanced"]},"match_original_utterances":{"type":"boolean","description":"Align translated utterances with the original ones","default":true},"lipsync":{"type":"boolean","description":"Whether to apply lipsync to the translated transcription. ","default":true},"context_adaptation":{"type":"boolean","description":"Enables or disables context-aware translation features that allow the model to adapt translations based on provided context.","default":true},"context":{"type":"string","description":"Context information to improve translation accuracy"},"informal":{"type":"boolean","description":"Forces the translation to use informal language forms when available in the target language.","default":false}},"required":["target_languages"],"type":"object","description":"Translation configuration, if `translation` is enabled"},"named_entity_recognition":{"type":"boolean","description":"If true, enable named entity recognition for the transcription.","default":false},"sentiment_analysis":{"type":"boolean","description":"If true, enable sentiment analysis for the transcription.","default":false}},"type":"object","description":"Specify the realtime processing configuration"},"post_processing":{"properties":{"summarization":{"type":"boolean","description":"If true, generates summarization for the whole transcription.","default":false},"summarization_config":{"properties":{"type":{"type":"string","description":"The type of summarization to apply","default":"general","enum":["general","bullet_points","concise"]}},"type":"object","description":"Summarization configuration, if `summarization` is enabled"},"chapterization":{"type":"boolean","description":"If true, generates chapters for the whole transcription.","default":false}},"type":"object","description":"Specify the post-processing configuration"},"messages_config":{"properties":{"receive_final_transcripts":{"type":"boolean","description":"If true, final utterance will be sent to websocket.","default":true},"receive_speech_events":{"type":"boolean","description":"If true, begin and end speech events will be sent to websocket.","default":true},"receive_pre_processing_events":{"type":"boolean","description":"If true, pre-processing events will be sent to websocket.","default":true},"receive_realtime_processing_events":{"type":"boolean","description":"If true, realtime processing events will be sent to websocket.","default":true},"receive_post_processing_events":{"type":"boolean","description":"If true, post-processing events will be sent to websocket.","default":true},"receive_acknowledgments":{"type":"boolean","description":"If true, acknowledgments will be sent to websocket.","default":true},"receive_errors":{"type":"boolean","description":"If true, errors will be sent to websocket.","default":true},"receive_lifecycle_events":{"type":"boolean","description":"If true, lifecycle events will be sent to websocket.","default":false}},"type":"object","description":"Specify the websocket messages configuration"},"callback":{"type":"boolean","description":"If true, messages will be sent to configured url.","default":false},"callback_config":{"properties":{"url":{"type":"string","description":"URL on which we will do a `POST` request with configured messages","example":"https://callback.example","format":"uri"},"receive_final_transcripts":{"type":"boolean","description":"If true, final utterance will be sent to the defined callback.","default":true},"receive_speech_events":{"type":"boolean","description":"If true, begin and end speech events will be sent to the defined callback.","default":false},"receive_pre_processing_events":{"type":"boolean","description":"If true, pre-processing events will be sent to the defined callback.","default":true},"receive_realtime_processing_events":{"type":"boolean","description":"If true, realtime processing events will be sent to the defined callback.","default":true},"receive_post_processing_events":{"type":"boolean","description":"If true, post-processing events will be sent to the defined callback.","default":true},"receive_acknowledgments":{"type":"boolean","description":"If true, acknowledgments will be sent to the defined callback.","default":false},"receive_errors":{"type":"boolean","description":"If true, errors will be sent to the defined callback.","default":false},"receive_lifecycle_events":{"type":"boolean","description":"If true, lifecycle events will be sent to the defined callback.","default":true}},"type":"object","description":"Specify the callback configuration"}},"title":"Gladia Real-time Transcription Settings","description":"Docs: https://docs.gladia.io/reference/live-audio"},"rev_streaming":{"type":"object","properties":{"obscure_expletives":{"type":"boolean"},"delete_after":{"type":"string","format":"date-span"},"audio_options._content_type":{"type":"string"},"audio_options._layout":{"type":"string"},"audio_options._rate":{"type":"integer","format":"int32"},"audio_options._format":{"type":"string"},"audio_options._channels":{"type":"integer","format":"int32"},"transcriber":{"enum":[0,1],"type":"integer","format":"int32"},"language":{"type":"string"},"metadata":{"maxLength":512,"minLength":0,"type":"string"},"filter_profanity":{"type":"boolean"},"remove_disfluencies":{"type":"boolean"},"detailed_partials":{"type":"boolean"},"custom_vocabulary_id":{"type":"string"},"delete_after_seconds":{"type":"integer","format":"int32"},"max_segment_duration_seconds":{"maximum":30,"minimum":5,"type":"integer","format":"int32"},"max_connection_wait_seconds":{"maximum":600,"minimum":60,"type":"integer","format":"int32"},"allow_interruption":{"type":"boolean"},"enable_speaker_switch":{"type":"boolean"},"start_ts":{"type":"string","format":"date-span"},"skip_postprocessing":{"type":"boolean"},"priority":{"enum":[0,1],"type":"integer","format":"int32"},"user_agent":{"type":"string"}},"title":"Rev Real-time Transcription Settings","description":"Docs: https://docs.rev.ai/api/streaming/requests/"},"aws_transcribe_streaming":{"type":"object","description":"You must specify either:\n- `language_code`(e.g `en-US`) OR\n- Set `language_identification` to `true` AND specify `language_options`(e.g `en-US,fr-FR,es-US,de-DE,it-IT`).\n\nDocs: https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html","properties":{"language_code":{"type":"string","description":"Specify the language code that represents the language spoken. If you're unsure of the language spoken in your audio, consider using IdentifyLanguage to enable automatic language identification."},"vocabulary_filter_method":{"type":"string","description":"Specify how you want your vocabulary filter applied to your transcript. To replace words with ***, choose mask. To delete words, choose remove. To flag words without changing them, choose tag."},"vocabulary_filter_name":{"type":"string","description":"Specify the name of the custom vocabulary filter that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive.  If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region. If you include IdentifyLanguage and want to use one or more vocabulary filters with your transcription, use the VocabularyFilterNames parameter instead."},"vocabulary_name":{"type":"string","description":"Specify the name of the custom vocabulary that you want to use when processing your transcription. Note that vocabulary names are case sensitive. If you use Amazon Transcribe multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region. If you include IdentifyLanguage and want to use one or more custom vocabularies with your transcription, use the VocabularyNames parameter instead."},"region":{"type":"string","description":"The Amazon Web Services Region in which to use Amazon Transcribe. If you don't specify a Region, then the MediaRegion of the meeting is used. However, if Amazon Transcribe is not available in the MediaRegion, then a TranscriptFailed event is sent. Use auto to use Amazon Transcribe in a Region near the meeting’s MediaRegion. For more information, refer to Choosing a transcription Region in the Amazon Chime SDK Developer Guide."},"enable_partial_results_stabilization":{"type":"boolean","description":"Enables partial result stabilization for your transcription. Partial result stabilization can reduce latency in your output, but may impact accuracy."},"partial_results_stability":{"type":"string","description":"Specify the level of stability to use when you enable partial results stabilization (EnablePartialResultsStabilization). Low stability provides the highest accuracy. High stability transcribes faster, but with slightly lower accuracy."},"content_identification_type":{"type":"string","description":"Labels all personally identifiable information (PII) identified in your transcript. If you don't include PiiEntityTypes, all PII is identified.  You can’t set ContentIdentificationType and ContentRedactionType. "},"content_redaction_type":{"type":"string","description":"Content redaction is performed at the segment level. If you don't include PiiEntityTypes, all PII is redacted.  You can’t set ContentRedactionType and ContentIdentificationType. "},"pii_entity_types":{"type":"string","description":"Specify which types of personally identifiable information (PII) you want to redact in your transcript. You can include as many types as you'd like, or you can select ALL. Values must be comma-separated and can include: ADDRESS, BANK_ACCOUNT_NUMBER, BANK_ROUTING, CREDIT_DEBIT_CVV, CREDIT_DEBIT_EXPIRY CREDIT_DEBIT_NUMBER, EMAIL,NAME, PHONE, PIN, SSN, or ALL. Note that if you include PiiEntityTypes, you must also include ContentIdentificationType or ContentRedactionType. If you include ContentRedactionType or ContentIdentificationType, but do not include PiiEntityTypes, all PII is redacted or identified."},"language_model_name":{"type":"string","description":"Specify the name of the custom language model that you want to use when processing your transcription. Note that language model names are case sensitive. The language of the specified language model must match the language code. If the languages don't match, the custom language model isn't applied. There are no errors or warnings associated with a language mismatch. If you use Amazon Transcribe in multiple Regions, the custom language model must be available in Amazon Transcribe in each Region."},"identify_language":{"type":"boolean","description":"Enables automatic language identification for your transcription. If you include IdentifyLanguage, you can optionally use LanguageOptions to include a list of language codes that you think may be present in your audio stream. Including language options can improve transcription accuracy. You can also use PreferredLanguage to include a preferred language. Doing so can help Amazon Transcribe identify the language faster. You must include either LanguageCode or IdentifyLanguage. Language identification can't be combined with custom language models or redaction."},"language_options":{"type":"string","description":"Specify two or more language codes that represent the languages you think may be present in your media; including more than five is not recommended. If you're unsure what languages are present, do not include this parameter. Including language options can improve the accuracy of language identification. If you include LanguageOptions, you must also include IdentifyLanguage.  You can only include one language dialect per language. For example, you cannot include en-US and en-AU. "},"preferred_language":{"type":"string","description":"Specify a preferred language from the subset of languages codes you specified in LanguageOptions. You can only use this parameter if you include IdentifyLanguage and LanguageOptions."},"vocabulary_names":{"type":"string","description":"Specify the names of the custom vocabularies that you want to use when processing your transcription. Note that vocabulary names are case sensitive. If you use Amazon Transcribe in multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region. If you don't include IdentifyLanguage and want to use a custom vocabulary with your transcription, use the VocabularyName parameter instead."},"vocabulary_filter_names":{"type":"string","description":"Specify the names of the custom vocabulary filters that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive. If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region.  If you're not including IdentifyLanguage and want to use a custom vocabulary filter with your transcription, use the VocabularyFilterName parameter instead."}},"oneOf":[{"required":["language_code"]},{"required":["identify_language","language_options"],"properties":{"identify_language":{"type":"boolean","enum":[true]}}}],"title":"AWS Transcribe Streaming Transcription Settings"},"speechmatics_streaming":{"type":"object","properties":{"language":{"type":"string"},"domain":{"type":"string","description":"Request a specialized model based on 'language' but optimized for a particular field, e.g. \"finance\" or \"medical\"."},"output_locale":{"type":"string","minLength":1},"additional_vocab":{"type":"array","items":{"type":"object","oneOf":[{"type":"string","minLength":1},{"type":"object","properties":{"content":{"type":"string","minLength":1},"sounds_like":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["content"]}]}},"diarization":{"type":"string","enum":["none","speaker"]},"max_delay":{"type":"number","minimum":0},"max_delay_mode":{"type":"string","enum":["flexible","fixed"]},"speaker_diarization_config":{"type":"object","properties":{"max_speakers":{"type":"number","format":"integer","minimum":2,"maximum":100},"prefer_current_speaker":{"type":"boolean"},"speaker_sensitivity":{"type":"number","format":"float","minimum":0,"maximum":1}}},"audio_filtering_config":{"type":"object","properties":{"volume_threshold":{"type":"number","format":"float","minimum":0,"maximum":100}}},"transcript_filtering_config":{"type":"object","properties":{"remove_disfluencies":{"type":"boolean"},"replacements":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"]}}}},"enable_partials":{"type":"boolean","default":false},"enable_entities":{"type":"boolean","default":true},"operating_point":{"type":"string","enum":["standard","enhanced"]},"punctuation_overrides":{"type":"object","properties":{"permitted_marks":{"type":"array","description":"The punctuation marks which the client is prepared to accept in transcription output, or the special value 'all' (the default). Unsupported marks are ignored. This value is used to guide the transcription process.","items":{"pattern":"^(.|all)$","type":"string"}},"sensitivity":{"type":"number","description":"Ranges between zero and one. Higher values will produce more punctuation. The default is 0.5.","format":"float","maximum":1,"minimum":0}}},"conversation_config":{"type":"object","properties":{"end_of_utterance_silence_trigger":{"type":"number","format":"float","minimum":0,"maximum":2,"default":0}},"description":"This mode will detect when a speaker has stopped talking. The end_of_utterance_silence_trigger is the time in seconds after which the server will assume that the speaker has finished speaking, and will emit an EndOfUtterance message. A value of 0 disables the feature."}},"required":["language"],"title":"Speechmatics Real-time Transcription Settings","description":"You must specify `language` (e.g `en`)\n\nDocs: https://docs.speechmatics.com/rt-api-ref#transcription-config"},"elevenlabs_streaming":{"type":"object","properties":{"model_id":{"description":"The model to use for transcription.","type":"string","default":"eleven_whisper_v2_realtime"},"language_code":{"description":"ISO 639-1 two-letter language code. When not specified, the model auto-detects the language.","type":"string"},"previous_text":{"description":"Text from a previous transcription session to provide context for the model. Sent in the first message to the WebSocket.","type":"string"}},"title":"ElevenLabs Real-time Transcription Settings","description":"Docs: https://elevenlabs.io/docs/api-reference/speech-to-text"},"meeting_captions":{"allOf":[{"$ref":"#/components/schemas/MeetingCaptions"}],"title":"Closed captions from the meeting platform","description":"Captures native meeting platform's built-in closed captions. **[Pros, cons, and supported platforms listed in the following guide.](https://docs.recall.ai/docs/meeting-caption-transcription)**"}}},"BotRecordingConfigTranscriptProviderRequest":{"type":"object","properties":{"recallai_streaming":{"allOf":[{"$ref":"#/components/schemas/RecallaiStreamingTranscriptionRequest"}],"title":"RecallAI Real-time Transcription Settings","description":" **[Read more in this guide](https://docs.recall.ai/docs/recallai-transcription)**"},"assembly_ai_async_chunked":{"properties":{"audio_end_at":{"x-label":"Audio end at","description":"The point in time, in milliseconds, to stop transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer"},"audio_start_from":{"x-label":"Audio start from","description":"The point in time, in milliseconds, to begin transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer"},"auto_chapters":{"x-label":"Auto chapters","description":"Enable [Auto Chapters](https://www.assemblyai.com/docs/speech-understanding/auto-chapters), can be true or false","type":"boolean","default":false},"auto_highlights":{"x-label":"Key phrases","description":"Enable [Key Phrases](https://www.assemblyai.com/docs/speech-understanding/key-phrases), either true or false","type":"boolean","default":false},"content_safety":{"x-label":"Content Moderation","description":"Enable [Content Moderation](https://www.assemblyai.com/docs/content-moderation), can be true or false","type":"boolean","default":false},"content_safety_confidence":{"x-label":"Content Moderation confidence","description":"The confidence threshold for the [Content Moderation](https://www.assemblyai.com/docs/content-moderation) model. Values must be between 25 and 100.","type":"integer","default":50,"minimum":25,"maximum":100},"custom_spelling":{"x-label":"Custom spellings","description":"Customize how words are spelled and formatted using to and from values. See [Custom Spelling](https://www.assemblyai.com/docs/pre-recorded-audio/custom-spelling) for more details.","type":"array","items":{"x-label":"Custom spelling","description":"Object containing words or phrases to replace, and the word or phrase to replace with","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"from":{"x-label":"From","description":"Words or phrases to replace","type":"array","items":{"x-label":"Word or phrase","description":"Word or phrase to replace","type":"string"}},"to":{"x-label":"To","description":"Word to replace with","type":"string"}},"required":["from","to"],"example":{"from":["dicarlo"],"to":"Decarlo"}}},"disfluencies":{"x-label":"Disfluencies","description":"Transcribe [Filler Words](https://www.assemblyai.com/docs/pre-recorded-audio/filler-words), like \"umm\", in your media file; can be true or false","type":"boolean","default":false},"entity_detection":{"x-label":"Entity Detection","description":"Enable [Entity Detection](https://www.assemblyai.com/docs/speech-understanding/entity-detection), can be true or false","type":"boolean","default":false},"filter_profanity":{"x-label":"Filter profanity","description":"Filter profanity from the transcribed text, can be true or false. See [Profanity Filtering](https://www.assemblyai.com/docs/profanity-filtering) for more details.","type":"boolean","default":false},"format_text":{"x-label":"Format text","description":"Enable [Text Formatting](https://www.assemblyai.com/docs/pre-recorded-audio), can be true or false","type":"boolean","default":true},"iab_categories":{"x-label":"Topic Detection","description":"Enable [Topic Detection](https://www.assemblyai.com/docs/speech-understanding/topic-detection), can be true or false","type":"boolean","default":false},"keyterms_prompt":{"x-label":"Keyterms prompt","description":"Improve accuracy with up to 200 (for Universal-2) or 1000 (for Universal-3-Pro) domain-specific words or phrases (maximum 6 words per phrase). See [Keyterms Prompting](https://www.assemblyai.com/docs/pre-recorded-audio/keyterms-prompting) for more details.\n","type":"array","items":{"x-label":"Keyterm","type":"string"}},"language_code":{"x-label":"Language code","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","oneOf":[{"anyOf":[{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"}}},{"type":"string"}]},{"type":"string","nullable":true}],"default":"en_us","x-ts-type":"LiteralUnion<TranscriptLanguageCode, string> | null","x-go-type":"TranscriptLanguageCode"},"language_codes":{"description":"The language codes of your audio file. Used for [Code switching](/docs/speech-to-text/pre-recorded-audio/code-switching)\nOne of the values specified must be `en`.\n","type":"array","items":{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"}}},"nullable":true},"language_confidence_threshold":{"x-label":"Language confidence threshold","description":"The confidence threshold for the automatically detected language.\nAn error will be returned if the language confidence is below this threshold.\nDefaults to 0. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0},"language_detection":{"x-label":"Language detection","description":"Enable [Automatic language detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection), either true or false.","type":"boolean","default":false},"language_detection_options":{"x-label":"Specify options for Automatic Language Detection.","description":"Specify options for [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection).","type":"object","additionalProperties":false,"properties":{"expected_languages":{"x-label":"Expected languages","description":"List of languages expected in the audio file. Defaults to `[\"all\"]` when unspecified. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.","type":"array","items":{"x-label":"language","type":"string"}},"fallback_language":{"x-label":"Fallback language","description":"If the detected language of the audio file is not in the list of expected languages, the `fallback_language` is used. Specify `[\"auto\"]` to let our model choose the fallback language from `expected_languages` with the highest confidence score. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"string","default":"auto"},"code_switching":{"x-label":"Code switching","description":"Whether [code switching](/docs/speech-to-text/pre-recorded-audio/code-switching) should be detected.\n","type":"boolean","default":false},"code_switching_confidence_threshold":{"x-label":"Code switching confidence threshold","description":"The confidence threshold for [code switching](/docs/speech-to-text/pre-recorded-audio/code-switching) detection. If the code switching confidence is below this threshold, the transcript will be processed in the language with the highest `language_detection_confidence` score.\n","type":"number","minimum":0,"maximum":1,"default":0.3}}},"multichannel":{"x-label":"Multichannel","description":"Enable [Multichannel](https://www.assemblyai.com/docs/pre-recorded-audio/multichannel) transcription, can be true or false.","type":"boolean","default":false},"prompt":{"x-label":"Prompt","description":"Provide natural language prompting of up to 1,500 words of contextual information to the model. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for best practices.\n\nNote: This parameter is only supported for the Universal-3-Pro model.\n","type":"string"},"punctuate":{"x-label":"Punctuate","description":"Enable [Automatic Punctuation](https://www.assemblyai.com/docs/pre-recorded-audio), can be true or false","type":"boolean","default":true},"redact_pii":{"x-label":"Redact PII","description":"Redact PII from the transcribed text using the Redact PII model, can be true or false. See [PII Redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"boolean","default":false},"redact_pii_audio":{"x-label":"Redact PII audio","description":"Generate a copy of the original media file with spoken PII \"beeped\" out, can be true or false. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","type":"boolean","default":false},"redact_pii_audio_options":{"x-label":"Specify options for PII redacted audio files.","description":"Specify options for [PII redacted audio](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) files.","type":"object","additionalProperties":false,"properties":{"return_redacted_no_speech_audio":{"x-label":"Return redacted no speech audio","description":"By default, audio redaction provides redacted audio URLs only when speech is detected. However, if your use-case specifically requires redacted audio files even for silent audio files without any dialogue, you can opt to receive these URLs by setting this parameter to `true`.","type":"boolean","default":false}}},"redact_pii_audio_quality":{"x-label":"Redact PII audio quality","type":"string","description":"Controls the filetype of the audio created by redact_pii_audio. Currently supports mp3 (default) and wav. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","x-fern-sdk-group-name":"transcripts","enum":["mp3","wav"],"x-fern-enum":{"mp3":{"description":"MP3 audio format is lower quality and lower size than WAV.","casing":{"camel":"mp3","snake":"mp3","pascal":"Mp3","screamingSnake":"MP3"}},"wav":{"description":"WAV audio format is the highest quality (no compression) and larger size than MP3."}},"x-aai-enum":{"mp3":{"label":"MP3"},"wav":{"label":"WAV"}},"example":"mp3"},"redact_pii_policies":{"x-label":"Redact PII policies","description":"The list of PII Redaction policies to enable. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"array","items":{"x-label":"PII policy","description":"The type of PII to redact","x-fern-sdk-group-name":"transcripts","type":"string","enum":["account_number","banking_information","blood_type","credit_card_cvv","credit_card_expiration","credit_card_number","date","date_interval","date_of_birth","drivers_license","drug","duration","email_address","event","filename","gender_sexuality","healthcare_number","injury","ip_address","language","location","marital_status","medical_condition","medical_process","money_amount","nationality","number_sequence","occupation","organization","passport_number","password","person_age","person_name","phone_number","physical_attribute","political_affiliation","religion","statistics","time","url","us_social_security_number","username","vehicle_id","zodiac_sign"],"x-fern-enum":{"account_number":{"description":"Customer account or membership identification number (e.g., Policy No. 10042992, Member ID: HZ-5235-001)"},"banking_information":{"description":"Banking information, including account and routing numbers"},"blood_type":{"description":"Blood type (e.g., O-, AB positive)"},"credit_card_cvv":{"description":"Credit card verification code (e.g., CVV: 080)"},"credit_card_expiration":{"description":"Expiration date of a credit card"},"credit_card_number":{"description":"Credit card number"},"date":{"description":"Specific calendar date (e.g., December 18)"},"date_interval":{"description":"Broader time periods, including date ranges, months, seasons, years, and decades (e.g., 2020-2021, 5-9 May, January 1984)"},"date_of_birth":{"description":"Date of birth (e.g., Date of Birth: March 7,1961)"},"drivers_license":{"description":"Driver's license number. (e.g., DL# 356933-540)"},"drug":{"description":"Medications, vitamins, or supplements (e.g., Advil, Acetaminophen, Panadol)"},"duration":{"description":"Periods of time, specified as a number and a unit of time (e.g., 8 months, 2 years)"},"email_address":{"description":"Email address (e.g., support@assemblyai.com)"},"event":{"description":"Name of an event or holiday (e.g., Olympics, Yom Kippur)"},"filename":{"description":"Names of computer files, including the extension or filepath (e.g., Taxes/2012/brad-tax-returns.pdf)"},"gender_sexuality":{"description":"Terms indicating gender identity or sexual orientation, including slang terms (e.g., female, bisexual, trans)"},"healthcare_number":{"description":"Healthcare numbers and health plan beneficiary numbers (e.g., Policy No.: 5584-486-674-YM)"},"injury":{"description":"Bodily injury (e.g., I broke my arm, I have a sprained wrist)"},"ip_address":{"description":"Internet IP address, including IPv4 and IPv6 formats (e.g., 192.168.0.1)"},"language":{"description":"Name of a natural language (e.g., Spanish, French)"},"location":{"description":"Any Location reference including mailing address, postal code, city, state, province, country, or coordinates. (e.g., Lake Victoria, 145 Windsor St., 90210)"},"marital_status":{"description":"Terms indicating marital status (e.g., Single, common-law, ex-wife, married)"},"medical_condition":{"description":"Name of a medical condition, disease, syndrome, deficit, or disorder (e.g., chronic fatigue syndrome, arrhythmia, depression)"},"medical_process":{"description":"Medical process, including treatments, procedures, and tests (e.g., heart surgery, CT scan)"},"money_amount":{"description":"Name and/or amount of currency (e.g., 15 pesos, $94.50)"},"nationality":{"description":"Terms indicating nationality, ethnicity, or race (e.g., American, Asian, Caucasian)"},"number_sequence":{"description":"Numerical PII (including alphanumeric strings) that doesn't fall under other categories"},"occupation":{"description":"Job title or profession (e.g., professor, actors, engineer, CPA)"},"organization":{"description":"Name of an organization (e.g., CNN, McDonalds, University of Alaska, Northwest General Hospital)"},"passport_number":{"description":"Passport numbers, issued by any country (e.g., PA4568332, NU3C6L86S12)"},"password":{"description":"Account passwords, PINs, access keys, or verification answers (e.g., 27%alfalfa, temp1234, My mother's maiden name is Smith)"},"person_age":{"description":"Number associated with an age (e.g., 27, 75)"},"person_name":{"description":"Name of a person (e.g., Bob, Doug Jones, Dr. Kay Martinez, MD)"},"phone_number":{"description":"Telephone or fax number"},"physical_attribute":{"description":"Distinctive bodily attributes, including terms indicating race (e.g., I'm 190cm tall, He belongs to the Black students' association)"},"political_affiliation":{"description":"Terms referring to a political party, movement, or ideology (e.g., Republican, Liberal)"},"religion":{"description":"Terms indicating religious affiliation (e.g., Hindu, Catholic)"},"statistics":{"description":"Medical statistics (e.g., 18%, 18 percent)"},"time":{"description":"Expressions indicating clock times (e.g., 19:37:28, 10pm EST)"},"url":{"description":"Internet addresses (e.g., https://www.assemblyai.com/)"},"us_social_security_number":{"description":"Social Security Number or equivalent"},"username":{"description":"Usernames, login names, or handles (e.g., @AssemblyAI)"},"vehicle_id":{"description":"Vehicle identification numbers (VINs), vehicle serial numbers, and license plate numbers (e.g., 5FNRL38918B111818, BIF7547)"},"zodiac_sign":{"description":"Names of Zodiac signs (e.g., Aries, Taurus)"}},"x-aai-enum":{"account_number":{"label":"Account number"},"banking_information":{"label":"Banking information"},"blood_type":{"label":"Blood type"},"credit_card_cvv":{"label":"Credit card CVV"},"credit_card_expiration":{"label":"Credit card expiration"},"credit_card_number":{"label":"Credit card number"},"date":{"label":"Date"},"date_interval":{"label":"Date interval"},"date_of_birth":{"label":"Date of birth"},"drivers_license":{"label":"Driver's license"},"drug":{"label":"Drug"},"duration":{"label":"Duration"},"email_address":{"label":"Email address"},"event":{"label":"Event"},"filename":{"label":"Filename"},"gender_sexuality":{"label":"Gender sexuality"},"healthcare_number":{"label":"Healthcare number"},"injury":{"label":"Injury"},"ip_address":{"label":"IP address"},"language":{"label":"Language"},"location":{"label":"Location"},"marital_status":{"label":"Marital status"},"medical_condition":{"label":"Medical condition"},"medical_process":{"label":"Medical process"},"money_amount":{"label":"Money amount"},"nationality":{"label":"Nationality"},"number_sequence":{"label":"Number sequence"},"occupation":{"label":"Occupation"},"organization":{"label":"Organization"},"passport_number":{"label":"Passport number"},"password":{"label":"Password"},"person_age":{"label":"Person age"},"person_name":{"label":"Person name"},"phone_number":{"label":"Phone number"},"physical_attribute":{"label":"Physical attribute"},"political_affiliation":{"label":"Political affiliation"},"religion":{"label":"Religion"},"statistics":{"label":"Statistics"},"time":{"label":"Time"},"url":{"label":"URL"},"us_social_security_number":{"label":"US Social Security Number"},"username":{"label":"Username"},"vehicle_id":{"label":"Vehicle ID"},"zodiac_sign":{"label":"Zodiac sign"}}}},"redact_pii_sub":{"x-label":"Redact PII substitution","description":"The replacement logic for detected PII, can be `entity_type` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","oneOf":[{"x-label":"Redact PII substitution","type":"string","x-fern-sdk-group-name":"transcripts","description":"The replacement logic for detected PII, can be `entity_name` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","enum":["entity_name","hash"],"x-aai-enum":{"entity_name":{"label":"Entity name"},"hash":{"label":"Hash"}}},{"type":"string","nullable":true}],"default":"hash"},"sentiment_analysis":{"x-label":"Sentiment Analysis","description":"Enable [Sentiment Analysis](https://www.assemblyai.com/docs/speech-understanding/sentiment-analysis), can be true or false","type":"boolean","default":false},"speaker_labels":{"x-label":"Speaker labels","description":"Enable [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization), can be true or false","type":"boolean","default":false},"speaker_options":{"x-label":"Specify options for speaker diarization.","description":"Specify options for [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers). Use this to set a range of possible speakers.","type":"object","additionalProperties":false,"properties":{"min_speakers_expected":{"x-label":"Minimum speakers expected","description":"The minimum number of speakers expected in the audio file. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers) for more details.","type":"integer","default":1},"max_speakers_expected":{"x-label":"Maximum speakers expected","description":"<Warning>Setting this parameter too high may hurt model accuracy</Warning>\nThe maximum number of speakers expected in the audio file. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers) for more details.\n","type":"integer","default":10}}},"speakers_expected":{"x-label":"Speakers expected","description":"Tells the speaker label model how many speakers it should attempt to identify. See [Set number of speakers expected](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-number-of-speakers-expected) for more details.","type":"integer","default":null,"nullable":true},"speech_models":{"x-label":"Speech models","description":"List multiple speech models in priority order, allowing our system to automatically route your audio to the best available option. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models and routing behavior.\n","type":"array","items":{"x-label":"Speech model","type":"string","description":"The speech model to use for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","x-fern-sdk-group-name":"transcripts"}},"speech_threshold":{"x-label":"Speech threshold","description":"Reject audio files that contain less than this fraction of speech.\nValid values are in the range [0, 1] inclusive. See [Speech Threshold](https://www.assemblyai.com/docs/speech-threshold) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0,"nullable":true},"speech_understanding":{"x-label":"Speech Understanding","description":"Enable speech understanding tasks like [Translation](https://www.assemblyai.com/docs/speech-understanding/translation), [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification), and [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting). See the task-specific docs for available options and configuration.\n","type":"object","properties":{"request":{"oneOf":[{"x-label":"Translation request body","description":"Request body for [Translation](https://www.assemblyai.com/docs/speech-understanding/translation).","type":"object","properties":{"translation":{"type":"object","properties":{"target_languages":{"type":"array","items":{"type":"string"},"description":"List of target language codes (e.g., `[\"es\", \"de\"]`). See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for supported languages."},"formal":{"type":"boolean","description":"Use formal language style. See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for more details.","default":true},"match_original_utterance":{"type":"boolean","description":"When enabled with Speaker Labels, returns translated text in the utterances array. Each utterance will include a `translated_texts` key containing translations for each target language.","default":false}},"required":["target_languages"]}},"required":["translation"]},{"type":"object","description":"Request body for [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification).","properties":{"speaker_identification":{"type":"object","properties":{"speaker_type":{"type":"string","enum":["role","name"],"description":"Type of speaker identification. See [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification) for details on each type."},"known_values":{"type":"array","items":{"type":"string"},"description":"Required if speaker_type is \"role\". Each value must be 35 characters or less."},"speakers":{"type":"array","description":"An array of speaker objects with metadata to improve identification accuracy. Each object should include a `role` or `name` (depending on `speaker_type`) and an optional `description` to help the model identify the speaker. You can also include any additional custom properties (e.g., `company`, `title`) to provide more context. Use this as an alternative to `known_values` when you want to provide additional context about each speaker.","items":{"type":"object","properties":{"role":{"type":"string","description":"The role of the speaker. Required when `speaker_type` is \"role\"."},"name":{"type":"string","description":"The name of the speaker. Required when `speaker_type` is \"name\"."},"description":{"type":"string","description":"A description of the speaker to help the model identify them based on conversational context."}},"additionalProperties":true}}},"required":["speaker_type"]}},"required":["speaker_identification"]},{"type":"object","description":"Request body for [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting).","properties":{"custom_formatting":{"type":"object","properties":{"date":{"type":"string","description":"Date format pattern (e.g., `\"mm/dd/yyyy\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."},"phone_number":{"type":"string","description":"Phone number format pattern (e.g., `\"(xxx)xxx-xxxx\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."},"email":{"type":"string","description":"Email format pattern (e.g., `\"username@domain.com\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."}}}},"required":["custom_formatting"]}]}},"required":["request"]},"summarization":{"x-label":"Enable Summarization","description":"Enable [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization), can be true or false","type":"boolean","default":false},"summary_model":{"type":"string","x-label":"Summary model","description":"The model to summarize the transcript","x-fern-sdk-group-name":"transcripts","enum":["informative","conversational","catchy"],"x-aai-enum":{"informative":{"label":"Informative"},"conversational":{"label":"Conversational"},"catchy":{"label":"Catchy"}}},"summary_type":{"type":"string","x-label":"Summary type","description":"The type of summary","x-fern-sdk-group-name":"transcripts","enum":["bullets","bullets_verbose","gist","headline","paragraph"],"x-aai-enum":{"bullets":{"label":"Bullets"},"bullets_verbose":{"label":"Bullets verbose"},"gist":{"label":"Gist"},"headline":{"label":"Headline"},"paragraph":{"label":"Paragraph"}}},"temperature":{"x-label":"Temperature","description":"Control the amount of randomness injected into the model's response. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for more details.\n\nNote: This parameter can only be used with the Universal-3-Pro model.\n","type":"number","minimum":0,"maximum":1,"default":0},"custom_topics":{"x-label":"Enable custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"boolean","default":false,"deprecated":true},"speech_model":{"x-label":"Speech model","description":"This parameter has been replaced with the `speech_models` parameter, learn more about the `speech_models` parameter [here](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model).\n","oneOf":[{"x-label":"Speech model","type":"string","description":"The speech model to use for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","x-fern-sdk-group-name":"transcripts"},{"type":"string","nullable":true}],"deprecated":true},"topics":{"x-label":"Custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"array","items":{"x-label":"Topic","type":"string"},"deprecated":true}},"type":"object","additionalProperties":false,"x-label":"Optional transcript parameters","description":"Docs: https://www.assemblyai.com/docs/api-reference/transcripts/submit","x-fern-sdk-group-name":"transcripts","example":{"speech_model":null,"language_code":"en_us","language_detection":true,"language_confidence_threshold":0.7,"punctuate":true,"format_text":true,"multichannel":true,"webhook_url":"https://your-webhook-url.tld/path","webhook_auth_header_name":"webhook-secret","webhook_auth_header_value":"webhook-secret-value","auto_highlights":true,"audio_start_from":10,"audio_end_at":280,"filter_profanity":true,"redact_pii":true,"redact_pii_audio":true,"redact_pii_audio_quality":"mp3","redact_pii_policies":["us_social_security_number","credit_card_number"],"redact_pii_sub":"hash","speaker_labels":true,"speakers_expected":2,"content_safety":true,"iab_categories":true,"custom_spelling":[],"disfluencies":false,"sentiment_analysis":true,"auto_chapters":true,"entity_detection":true,"speech_threshold":0.5,"summarization":true,"summary_model":"informative","summary_type":"bullets","custom_topics":true,"topics":[],"speech_understanding":{"request":{"translation":{"target_languages":["es","de"],"formal":true,"match_original_utterance":true}}}},"title":"AssemblyAi async chunked transcription Settings"},"assembly_ai_v3_streaming":{"type":"object","properties":{"speech_model":{"description":"The speech model used for your Streaming session.","enum":["universal-streaming-english","universal-streaming-multilingual","whisper-rt","u3-rt-pro"]},"format_turns":{"description":"Whether to return formatted final transcripts.","default":false,"type":"boolean"},"inactivity_timeout":{"description":"Optional time in seconds of inactivity before session is terminated. If not set, no inactivity timeout is applied.","default":"None","format":"s","type":"integer","minimum":5,"maximum":3600},"keyterms_prompt":{"description":"A list of words and phrases to improve recognition accuracy for. See [Keyterms Prompting](https://www.assemblyai.com/docs/streaming/keyterms-prompting) for more details.","type":"array","items":{"x-label":"Word","type":"string"}},"language_detection":{"description":"Whether to detect the language and return language metadata on utterances and final turns. Only available for the multilingual model.","enum":["true","false"],"default":"false"},"max_turn_silence":{"description":"The maximum amount of silence in milliseconds allowed in a turn before end of turn is triggered. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","type":"integer","default":1280},"min_turn_silence":{"description":"The minimum amount of silence in milliseconds required to detect end of turn when confident. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","type":"integer","default":400},"vad_threshold":{"description":"The confidence threshold (0.0 to 1.0) for classifying audio frames as silence. Frames with VAD confidence below this value are considered silent. Increase for noisy environments to reduce false speech detection.","default":0.4,"type":"number"},"end_of_turn_confidence_threshold":{"description":"The confidence threshold (0.0 to 1.0) to use when determining if the end of a turn has been reached. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","deprecated":true,"type":"number","default":0.4},"language":{"description":"The language of your audio stream.","enum":["en","multi"],"default":"en","deprecated":true}},"title":"AssemblyAi Real-time Transcription Settings","description":"Docs: https://www.assemblyai.com/docs/api-reference/streaming-api/streaming-api"},"deepgram_streaming":{"type":"object","properties":{"diarize":{"description":"Defaults to `false`. Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0","default":"false","enum":["true","false"]},"dictation":{"description":"Identify and extract key entities from content in submitted audio","default":"false","enum":["true","false"]},"endpointing":{"description":"Indicates how long Deepgram will wait to detect whether a speaker has finished speaking or pauses for a significant period of time. When set to a value, the streaming endpoint immediately finalizes the transcription for the processed time range and returns the transcript with a speech_final parameter set to true. Can also be set to false to disable endpointing","default":"10"},"extra":{"description":"Arbitrary key-value pairs that are attached to the API response for usage in downstream processing"},"filler_words":{"description":"Filler Words can help transcribe interruptions in your audio, like \"uh\" and \"um\"","default":"false","enum":["true","false"]},"interim_results":{"description":"Specifies whether the streaming endpoint should provide ongoing transcription updates as more audio is received. When set to true, the endpoint sends continuous updates, meaning transcription results may evolve over time","default":"false","enum":["true","false"]},"keyterm":{"description":"Key term prompting can boost or suppress specialized terminology and brands. Only compatible with Nova-3"},"keywords":{"description":"Keywords can boost or suppress specialized terminology and brands"},"language":{"description":"The [BCP-47 language tag](https://tools.ietf.org/html/bcp47) that hints at the primary spoken language. Depending on the Model you choose only certain languages are available","default":"en","enum":["bg","ca","cs","da","da-DK","de","de-CH","el","en","en-AU","en-GB","en-IN","en-NZ","en-US","es","es-419","es-LATAM","et","fi","fr","fr-CA","hi","hi-Latn","hu","id","it","ja","ko","ko-KR","lt","lv","ms","multi","nl","nl-BE","no","pl","pt","pt-BR","pt-PT","ro","ru","sk","sv","sv-SE","taq","th","th-TH","tr","uk","vi","zh","zh-CN","zh-HK","zh-Hans","zh-Hant","zh-TW"]},"mip_opt_out":{"description":"Opts out requests from the Deepgram Model Improvement Program. Refer to our Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mip","default":"false"},"model":{"description":"AI model to use for the transcription","enum":["nova-3","nova-3-general","nova-3-medical","nova-2","nova-2-general","nova-2-meeting","nova-2-finance","nova-2-conversationalai","nova-2-voicemail","nova-2-video","nova-2-medical","nova-2-drivethru","nova-2-automotive","nova","nova-general","nova-phonecall","nova-medical","enhanced","enhanced-general","enhanced-meeting","enhanced-phonecall","enhanced-finance","base","meeting","phonecall","finance","conversationalai","voicemail","video","custom"]},"multichannel":{"description":"Transcribe each audio channel independently","default":"false","enum":["true","false"]},"numerals":{"description":"Convert numbers from written format to numerical format","default":"false","enum":["true","false"]},"profanity_filter":{"description":"Profanity Filter looks for recognized profanity and converts it to the nearest recognized non-profane word or removes it from the transcript completely","default":"false","enum":["true","false"]},"punctuate":{"description":"Add punctuation and capitalization to the transcript","default":"false","enum":["true","false"]},"redact":{"description":"Redaction removes sensitive information from your transcripts","default":"false","enum":["true","false","pci","numbers","aggressive_numbers","ssn"]},"replace":{"description":"Search for terms or phrases in submitted audio and replaces them"},"search":{"description":"Search for terms or phrases in submitted audio"},"smart_format":{"description":"Apply formatting to transcript output. When set to true, additional formatting will be applied to transcripts to improve readability","default":"false","enum":["true","false"]},"tag":{"description":"Label your requests for the purpose of identification during usage reporting"},"utterance_end_ms":{"description":"Indicates how long Deepgram will wait to send an UtteranceEnd message after a word has been transcribed. Use with interim_results"},"vad_events":{"description":"Indicates that speech has started. You'll begin receiving Speech Started messages upon speech starting","default":"false","enum":["true","false"]},"version":{"description":"Version of an AI model to use","default":"latest"}},"title":"Deepgram Real-time Transcription Settings","description":"Docs: https://developers.deepgram.com/reference/streaming"},"gladia_v2_streaming":{"type":"object","properties":{"custom_metadata":{"type":"object","description":"Custom metadata you can attach to this live transcription","example":{"user":"John Doe"}},"model":{"type":"string","description":"The model used to process the audio. \"solaria-1\" is used by default.","default":"solaria-1","enum":["solaria-1"]},"endpointing":{"type":"number","description":"The endpointing duration in seconds. Endpointing is the duration of silence which will cause an utterance to be considered as finished","default":0.05,"minimum":0.01,"maximum":10},"maximum_duration_without_endpointing":{"type":"number","description":"The maximum duration in seconds without endpointing. If endpointing is not detected after this duration, current utterance will be considered as finished","default":5,"minimum":5,"maximum":60},"language_config":{"properties":{"languages":{"type":"array","description":"If one language is set, it will be used for the transcription. Otherwise, language will be auto-detected by the model.","default":[],"items":{"type":"string","enum":["af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","ca","zh","hr","cs","da","nl","en","et","fo","fi","fr","gl","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","id","it","ja","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","mymr","ne","no","nn","oc","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","jp"]}},"code_switching":{"type":"boolean","description":"If true, language will be auto-detected on each utterance. Otherwise, language will be auto-detected on first utterance and then used for the rest of the transcription. If one language is set, this option will be ignored.","default":false}},"type":"object","description":"Specify the language configuration"},"pre_processing":{"properties":{"audio_enhancer":{"type":"boolean","description":"If true, apply pre-processing to the audio stream to enhance the quality.","default":false},"speech_threshold":{"type":"number","description":"Sensitivity configuration for Speech Threshold. A value close to 1 will apply stricter thresholds, making it less likely to detect background sounds as speech.","default":0.6,"minimum":0,"maximum":1}},"type":"object","description":"Specify the pre-processing configuration"},"realtime_processing":{"properties":{"custom_vocabulary":{"type":"boolean","description":"If true, enable custom vocabulary for the transcription.","default":false},"custom_vocabulary_config":{"properties":{"vocabulary":{"description":"Specific vocabulary list to feed the transcription model with. Each item can be a string or an object with the following properties: value, intensity, pronunciations, language.","example":["Westeros",{"value":"Stark"},{"value":"Night's Watch","pronunciations":["Nightz Watch"],"intensity":0.4,"language":"en"}],"type":"array","items":{"oneOf":[{"type":"object","properties":{"value":{"type":"string","description":"The text used to replace in the transcription.","example":"Gladia"},"intensity":{"type":"number","description":"The global intensity of the feature.","example":0.5,"minimum":0,"maximum":1},"pronunciations":{"description":"The pronunciations used in the transcription.","type":"array","items":{"type":"string"}},"language":{"type":"string","description":"Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.","example":"en"}},"required":["value"]},{"type":"string"}]}},"default_intensity":{"type":"number","description":"Default intensity for the custom vocabulary","example":0.5,"minimum":0,"maximum":1}},"required":["vocabulary"],"type":"object","description":"Custom vocabulary configuration, if `custom_vocabulary` is enabled"},"custom_spelling":{"type":"boolean","description":"If true, enable custom spelling for the transcription.","default":false},"custom_spelling_config":{"properties":{"spelling_dictionary":{"type":"object","description":"The list of spelling applied on the audio transcription","example":{"Gettleman":["gettleman"],"SQL":["Sequel"]}}},"required":["spelling_dictionary"],"type":"object","description":"Custom spelling configuration, if `custom_spelling` is enabled"},"translation":{"type":"boolean","description":"If true, enable translation for the transcription","default":false},"translation_config":{"properties":{"target_languages":{"type":"array","example":["en"],"minItems":1,"items":{"type":"string","description":"The target language in `iso639-1` format","enum":["af","sq","am","ar","hy","as","ast","az","ba","eu","be","bn","bs","br","bg","my","ca","ceb","zh","hr","cs","da","nl","en","et","fo","fi","nl","fr","fy","ff","gd","gl","lg","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","ig","ilo","id","ga","it","ja","jp","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mo","mn","mymr","ne","no","nn","oc","or","pa","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","ss","sv","tl","tg","ta","tt","te","th","bo","tn","tr","tk","uk","ur","uz","vi","cy","wo","xh","yi","yo","zu"]}},"model":{"type":"string","description":"Model you want the translation model to use to translate","default":"base","enum":["base","enhanced"]},"match_original_utterances":{"type":"boolean","description":"Align translated utterances with the original ones","default":true},"lipsync":{"type":"boolean","description":"Whether to apply lipsync to the translated transcription. ","default":true},"context_adaptation":{"type":"boolean","description":"Enables or disables context-aware translation features that allow the model to adapt translations based on provided context.","default":true},"context":{"type":"string","description":"Context information to improve translation accuracy"},"informal":{"type":"boolean","description":"Forces the translation to use informal language forms when available in the target language.","default":false}},"required":["target_languages"],"type":"object","description":"Translation configuration, if `translation` is enabled"},"named_entity_recognition":{"type":"boolean","description":"If true, enable named entity recognition for the transcription.","default":false},"sentiment_analysis":{"type":"boolean","description":"If true, enable sentiment analysis for the transcription.","default":false}},"type":"object","description":"Specify the realtime processing configuration"},"post_processing":{"properties":{"summarization":{"type":"boolean","description":"If true, generates summarization for the whole transcription.","default":false},"summarization_config":{"properties":{"type":{"type":"string","description":"The type of summarization to apply","default":"general","enum":["general","bullet_points","concise"]}},"type":"object","description":"Summarization configuration, if `summarization` is enabled"},"chapterization":{"type":"boolean","description":"If true, generates chapters for the whole transcription.","default":false}},"type":"object","description":"Specify the post-processing configuration"},"messages_config":{"properties":{"receive_final_transcripts":{"type":"boolean","description":"If true, final utterance will be sent to websocket.","default":true},"receive_speech_events":{"type":"boolean","description":"If true, begin and end speech events will be sent to websocket.","default":true},"receive_pre_processing_events":{"type":"boolean","description":"If true, pre-processing events will be sent to websocket.","default":true},"receive_realtime_processing_events":{"type":"boolean","description":"If true, realtime processing events will be sent to websocket.","default":true},"receive_post_processing_events":{"type":"boolean","description":"If true, post-processing events will be sent to websocket.","default":true},"receive_acknowledgments":{"type":"boolean","description":"If true, acknowledgments will be sent to websocket.","default":true},"receive_errors":{"type":"boolean","description":"If true, errors will be sent to websocket.","default":true},"receive_lifecycle_events":{"type":"boolean","description":"If true, lifecycle events will be sent to websocket.","default":false}},"type":"object","description":"Specify the websocket messages configuration"},"callback":{"type":"boolean","description":"If true, messages will be sent to configured url.","default":false},"callback_config":{"properties":{"url":{"type":"string","description":"URL on which we will do a `POST` request with configured messages","example":"https://callback.example","format":"uri"},"receive_final_transcripts":{"type":"boolean","description":"If true, final utterance will be sent to the defined callback.","default":true},"receive_speech_events":{"type":"boolean","description":"If true, begin and end speech events will be sent to the defined callback.","default":false},"receive_pre_processing_events":{"type":"boolean","description":"If true, pre-processing events will be sent to the defined callback.","default":true},"receive_realtime_processing_events":{"type":"boolean","description":"If true, realtime processing events will be sent to the defined callback.","default":true},"receive_post_processing_events":{"type":"boolean","description":"If true, post-processing events will be sent to the defined callback.","default":true},"receive_acknowledgments":{"type":"boolean","description":"If true, acknowledgments will be sent to the defined callback.","default":false},"receive_errors":{"type":"boolean","description":"If true, errors will be sent to the defined callback.","default":false},"receive_lifecycle_events":{"type":"boolean","description":"If true, lifecycle events will be sent to the defined callback.","default":true}},"type":"object","description":"Specify the callback configuration"}},"title":"Gladia Real-time Transcription Settings","description":"Docs: https://docs.gladia.io/reference/live-audio"},"rev_streaming":{"type":"object","properties":{"obscure_expletives":{"type":"boolean"},"delete_after":{"type":"string","format":"date-span"},"audio_options._content_type":{"type":"string"},"audio_options._layout":{"type":"string"},"audio_options._rate":{"type":"integer","format":"int32"},"audio_options._format":{"type":"string"},"audio_options._channels":{"type":"integer","format":"int32"},"transcriber":{"enum":[0,1],"type":"integer","format":"int32"},"language":{"type":"string"},"metadata":{"maxLength":512,"minLength":0,"type":"string"},"filter_profanity":{"type":"boolean"},"remove_disfluencies":{"type":"boolean"},"detailed_partials":{"type":"boolean"},"custom_vocabulary_id":{"type":"string"},"delete_after_seconds":{"type":"integer","format":"int32"},"max_segment_duration_seconds":{"maximum":30,"minimum":5,"type":"integer","format":"int32"},"max_connection_wait_seconds":{"maximum":600,"minimum":60,"type":"integer","format":"int32"},"allow_interruption":{"type":"boolean"},"enable_speaker_switch":{"type":"boolean"},"start_ts":{"type":"string","format":"date-span"},"skip_postprocessing":{"type":"boolean"},"priority":{"enum":[0,1],"type":"integer","format":"int32"},"user_agent":{"type":"string"}},"title":"Rev Real-time Transcription Settings","description":"Docs: https://docs.rev.ai/api/streaming/requests/"},"aws_transcribe_streaming":{"type":"object","description":"You must specify either:\n- `language_code`(e.g `en-US`) OR\n- Set `language_identification` to `true` AND specify `language_options`(e.g `en-US,fr-FR,es-US,de-DE,it-IT`).\n\nDocs: https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html","properties":{"language_code":{"type":"string","description":"Specify the language code that represents the language spoken. If you're unsure of the language spoken in your audio, consider using IdentifyLanguage to enable automatic language identification."},"vocabulary_filter_method":{"type":"string","description":"Specify how you want your vocabulary filter applied to your transcript. To replace words with ***, choose mask. To delete words, choose remove. To flag words without changing them, choose tag."},"vocabulary_filter_name":{"type":"string","description":"Specify the name of the custom vocabulary filter that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive.  If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region. If you include IdentifyLanguage and want to use one or more vocabulary filters with your transcription, use the VocabularyFilterNames parameter instead."},"vocabulary_name":{"type":"string","description":"Specify the name of the custom vocabulary that you want to use when processing your transcription. Note that vocabulary names are case sensitive. If you use Amazon Transcribe multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region. If you include IdentifyLanguage and want to use one or more custom vocabularies with your transcription, use the VocabularyNames parameter instead."},"region":{"type":"string","description":"The Amazon Web Services Region in which to use Amazon Transcribe. If you don't specify a Region, then the MediaRegion of the meeting is used. However, if Amazon Transcribe is not available in the MediaRegion, then a TranscriptFailed event is sent. Use auto to use Amazon Transcribe in a Region near the meeting’s MediaRegion. For more information, refer to Choosing a transcription Region in the Amazon Chime SDK Developer Guide."},"enable_partial_results_stabilization":{"type":"boolean","description":"Enables partial result stabilization for your transcription. Partial result stabilization can reduce latency in your output, but may impact accuracy."},"partial_results_stability":{"type":"string","description":"Specify the level of stability to use when you enable partial results stabilization (EnablePartialResultsStabilization). Low stability provides the highest accuracy. High stability transcribes faster, but with slightly lower accuracy."},"content_identification_type":{"type":"string","description":"Labels all personally identifiable information (PII) identified in your transcript. If you don't include PiiEntityTypes, all PII is identified.  You can’t set ContentIdentificationType and ContentRedactionType. "},"content_redaction_type":{"type":"string","description":"Content redaction is performed at the segment level. If you don't include PiiEntityTypes, all PII is redacted.  You can’t set ContentRedactionType and ContentIdentificationType. "},"pii_entity_types":{"type":"string","description":"Specify which types of personally identifiable information (PII) you want to redact in your transcript. You can include as many types as you'd like, or you can select ALL. Values must be comma-separated and can include: ADDRESS, BANK_ACCOUNT_NUMBER, BANK_ROUTING, CREDIT_DEBIT_CVV, CREDIT_DEBIT_EXPIRY CREDIT_DEBIT_NUMBER, EMAIL,NAME, PHONE, PIN, SSN, or ALL. Note that if you include PiiEntityTypes, you must also include ContentIdentificationType or ContentRedactionType. If you include ContentRedactionType or ContentIdentificationType, but do not include PiiEntityTypes, all PII is redacted or identified."},"language_model_name":{"type":"string","description":"Specify the name of the custom language model that you want to use when processing your transcription. Note that language model names are case sensitive. The language of the specified language model must match the language code. If the languages don't match, the custom language model isn't applied. There are no errors or warnings associated with a language mismatch. If you use Amazon Transcribe in multiple Regions, the custom language model must be available in Amazon Transcribe in each Region."},"identify_language":{"type":"boolean","description":"Enables automatic language identification for your transcription. If you include IdentifyLanguage, you can optionally use LanguageOptions to include a list of language codes that you think may be present in your audio stream. Including language options can improve transcription accuracy. You can also use PreferredLanguage to include a preferred language. Doing so can help Amazon Transcribe identify the language faster. You must include either LanguageCode or IdentifyLanguage. Language identification can't be combined with custom language models or redaction."},"language_options":{"type":"string","description":"Specify two or more language codes that represent the languages you think may be present in your media; including more than five is not recommended. If you're unsure what languages are present, do not include this parameter. Including language options can improve the accuracy of language identification. If you include LanguageOptions, you must also include IdentifyLanguage.  You can only include one language dialect per language. For example, you cannot include en-US and en-AU. "},"preferred_language":{"type":"string","description":"Specify a preferred language from the subset of languages codes you specified in LanguageOptions. You can only use this parameter if you include IdentifyLanguage and LanguageOptions."},"vocabulary_names":{"type":"string","description":"Specify the names of the custom vocabularies that you want to use when processing your transcription. Note that vocabulary names are case sensitive. If you use Amazon Transcribe in multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region. If you don't include IdentifyLanguage and want to use a custom vocabulary with your transcription, use the VocabularyName parameter instead."},"vocabulary_filter_names":{"type":"string","description":"Specify the names of the custom vocabulary filters that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive. If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region.  If you're not including IdentifyLanguage and want to use a custom vocabulary filter with your transcription, use the VocabularyFilterName parameter instead."}},"oneOf":[{"required":["language_code"]},{"required":["identify_language","language_options"],"properties":{"identify_language":{"type":"boolean","enum":[true]}}}],"title":"AWS Transcribe Streaming Transcription Settings"},"speechmatics_streaming":{"type":"object","properties":{"language":{"type":"string"},"domain":{"type":"string","description":"Request a specialized model based on 'language' but optimized for a particular field, e.g. \"finance\" or \"medical\"."},"output_locale":{"type":"string","minLength":1},"additional_vocab":{"type":"array","items":{"type":"object","oneOf":[{"type":"string","minLength":1},{"type":"object","properties":{"content":{"type":"string","minLength":1},"sounds_like":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["content"]}]}},"diarization":{"type":"string","enum":["none","speaker"]},"max_delay":{"type":"number","minimum":0},"max_delay_mode":{"type":"string","enum":["flexible","fixed"]},"speaker_diarization_config":{"type":"object","properties":{"max_speakers":{"type":"number","format":"integer","minimum":2,"maximum":100},"prefer_current_speaker":{"type":"boolean"},"speaker_sensitivity":{"type":"number","format":"float","minimum":0,"maximum":1}}},"audio_filtering_config":{"type":"object","properties":{"volume_threshold":{"type":"number","format":"float","minimum":0,"maximum":100}}},"transcript_filtering_config":{"type":"object","properties":{"remove_disfluencies":{"type":"boolean"},"replacements":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"]}}}},"enable_partials":{"type":"boolean","default":false},"enable_entities":{"type":"boolean","default":true},"operating_point":{"type":"string","enum":["standard","enhanced"]},"punctuation_overrides":{"type":"object","properties":{"permitted_marks":{"type":"array","description":"The punctuation marks which the client is prepared to accept in transcription output, or the special value 'all' (the default). Unsupported marks are ignored. This value is used to guide the transcription process.","items":{"pattern":"^(.|all)$","type":"string"}},"sensitivity":{"type":"number","description":"Ranges between zero and one. Higher values will produce more punctuation. The default is 0.5.","format":"float","maximum":1,"minimum":0}}},"conversation_config":{"type":"object","properties":{"end_of_utterance_silence_trigger":{"type":"number","format":"float","minimum":0,"maximum":2,"default":0}},"description":"This mode will detect when a speaker has stopped talking. The end_of_utterance_silence_trigger is the time in seconds after which the server will assume that the speaker has finished speaking, and will emit an EndOfUtterance message. A value of 0 disables the feature."}},"required":["language"],"title":"Speechmatics Real-time Transcription Settings","description":"You must specify `language` (e.g `en`)\n\nDocs: https://docs.speechmatics.com/rt-api-ref#transcription-config"},"elevenlabs_streaming":{"type":"object","properties":{"model_id":{"description":"The model to use for transcription.","type":"string","default":"eleven_whisper_v2_realtime"},"language_code":{"description":"ISO 639-1 two-letter language code. When not specified, the model auto-detects the language.","type":"string"},"previous_text":{"description":"Text from a previous transcription session to provide context for the model. Sent in the first message to the WebSocket.","type":"string"}},"title":"ElevenLabs Real-time Transcription Settings","description":"Docs: https://elevenlabs.io/docs/api-reference/speech-to-text"},"meeting_captions":{"allOf":[{"$ref":"#/components/schemas/MeetingCaptionsRequest"}],"title":"Closed captions from the meeting platform","description":"Captures native meeting platform's built-in closed captions. **[Pros, cons, and supported platforms listed in the following guide.](https://docs.recall.ai/docs/meeting-caption-transcription)**"}}},"BotRecordingEmbed":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"started_at":{"type":"string","format":"date-time","nullable":true},"completed_at":{"type":"string","format":"date-time","nullable":true},"expires_at":{"type":"string","format":"date-time","nullable":true},"status":{"allOf":[{"$ref":"#/components/schemas/RecordingStatus"}],"readOnly":true,"nullable":true},"media_shortcuts":{"allOf":[{"$ref":"#/components/schemas/RecordingShortcuts"}],"readOnly":true,"nullable":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}}},"required":["created_at","id","media_shortcuts","status"]},"BotRecordingEmbedRequest":{"type":"object","properties":{"started_at":{"type":"string","format":"date-time","nullable":true},"completed_at":{"type":"string","format":"date-time","nullable":true},"expires_at":{"type":"string","format":"date-time","nullable":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"BotRequest":{"type":"object","properties":{"meeting_url":{"type":"string","description":"The url of the meeting. For example, https://zoom.us/j/123?pwd=456. This field will be cleared a few days after the bot has joined a call."},"bot_name":{"type":"string","minLength":1,"default":"Meeting Notetaker","description":"The name of the bot that will be displayed in the call.\n*(Note: Authenticated Google Meet bots will use the Google account name and this field will be ignored.)*","maxLength":100},"join_at":{"type":"string","format":"date-time","nullable":true,"description":"The time at which the bot will join the call, formatted in ISO 8601. This field can only be read from scheduled bots that have not yet joined a call."},"recording_config":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRequest"}],"nullable":true,"description":"Configure the recording generated by the bot. Includes options for getting meeting transcript,  the layout of the recorded video, when to start recording and more."},"output_media":{"allOf":[{"$ref":"#/components/schemas/OutputMediaRequest"}],"nullable":true,"description":"Settings for the bot output media."},"automatic_video_output":{"allOf":[{"$ref":"#/components/schemas/AutomaticVideoOutputRequest"}],"nullable":true,"description":"Settings for the bot to output video. Image should be 16:9. Read more about this here: https://docs.recall.ai/docs/output-video-in-meetings"},"automatic_audio_output":{"allOf":[{"$ref":"#/components/schemas/AutomaticAudioOutputRequest"}],"nullable":true,"description":"Settings for the bot to output audio."},"chat":{"allOf":[{"$ref":"#/components/schemas/ChatRequest"}],"nullable":true,"description":"Settings for the bot to send chat messages. \n*(Note: Chat functionality is only supported for Zoom, Google Meet and Microsoft Teams currently.)*"},"automatic_leave":{"allOf":[{"$ref":"#/components/schemas/AutomaticLeaveRequest"}],"nullable":true},"variant":{"allOf":[{"$ref":"#/components/schemas/BotVariantRequest"}],"nullable":true,"description":"Configure bot variants per meeting platforms, e.g. {\"zoom\": \"web_4_core\"}."},"zoom":{"allOf":[{"$ref":"#/components/schemas/ZoomRequest"}],"nullable":true,"description":"Zoom specific parameters"},"google_meet":{"allOf":[{"$ref":"#/components/schemas/GoogleMeetRequest"}],"nullable":true,"description":"Google Meet specific parameters"},"webex":{"allOf":[{"$ref":"#/components/schemas/WebexRequest"}],"nullable":true,"description":"Webex specific parameters"},"breakout_room":{"allOf":[{"$ref":"#/components/schemas/_BreakoutRoomSchemaRequest"}],"nullable":true,"description":"Configure how the bot handles breakout rooms. Currently, Zoom is supported.Examples: {\"mode\": \"join_main_room\"} | {\"mode\": \"join_specific_room\", \"room_id\": \"<uuid>\"} | {\"mode\": \"auto_accept_all_invites\"} (default)."},"metadata":{"type":"object","additionalProperties":{"type":"string"}}},"required":["meeting_url"]},"BotScreenshot":{"type":"object","properties":{"id":{"type":"string"},"recorded_at":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri"}},"required":["id","recorded_at","url"]},"BotVariant":{"type":"object","properties":{"zoom":{"allOf":[{"$ref":"#/components/schemas/ZoomEnum"}],"description":"Choose the bot variant to use for Zoom meetings."},"google_meet":{"allOf":[{"$ref":"#/components/schemas/GoogleMeetEnum"}],"description":"Choose the bot variant to use for Google Meet meetings.\n\n* `web` - web\n* `web_4_core` - web_4_core\n* `web_gpu` - web_gpu"},"microsoft_teams":{"allOf":[{"$ref":"#/components/schemas/MicrosoftTeamsEnum"}],"description":"Choose the bot variant to use for Microsoft Teams meetings.\n\n* `web` - web\n* `web_4_core` - web_4_core\n* `web_gpu` - web_gpu"},"webex":{"allOf":[{"$ref":"#/components/schemas/WebexEnum"}],"description":"Choose the bot variant to use for Webex meetings.\n\n* `web` - web\n* `web_4_core` - web_4_core\n* `web_gpu` - web_gpu"}}},"BotVariantRequest":{"type":"object","properties":{"zoom":{"allOf":[{"$ref":"#/components/schemas/ZoomEnum"}],"description":"Choose the bot variant to use for Zoom meetings."},"google_meet":{"allOf":[{"$ref":"#/components/schemas/GoogleMeetEnum"}],"description":"Choose the bot variant to use for Google Meet meetings.\n\n* `web` - web\n* `web_4_core` - web_4_core\n* `web_gpu` - web_gpu"},"microsoft_teams":{"allOf":[{"$ref":"#/components/schemas/MicrosoftTeamsEnum"}],"description":"Choose the bot variant to use for Microsoft Teams meetings.\n\n* `web` - web\n* `web_4_core` - web_4_core\n* `web_gpu` - web_gpu"},"webex":{"allOf":[{"$ref":"#/components/schemas/WebexEnum"}],"description":"Choose the bot variant to use for Webex meetings.\n\n* `web` - web\n* `web_4_core` - web_4_core\n* `web_gpu` - web_gpu"}}},"Calendar":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"oauth_client_id":{"type":"string","maxLength":2000},"oauth_client_secret":{"type":"string","maxLength":2000},"oauth_refresh_token":{"type":"string","maxLength":10000},"platform":{"$ref":"#/components/schemas/CalendarPlatformEnum"},"webhook_url":{"type":"string","format":"uri","maxLength":2000,"deprecated":true},"oauth_email":{"type":"string","format":"email","maxLength":2000},"platform_email":{"type":"string","readOnly":true,"nullable":true},"status":{"type":"string","readOnly":true},"status_changes":{"type":"array","items":{"$ref":"#/components/schemas/CalendarStatusChange"},"readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true}},"required":["created_at","id","oauth_client_id","oauth_client_secret","oauth_refresh_token","platform","platform_email","status","status_changes","updated_at"]},"CalendarAccessToken":{"type":"object","properties":{"token":{"type":"string","readOnly":true},"expires_at":{"type":"string","format":"date-time","readOnly":true}},"required":["expires_at","token"]},"CalendarAccountAccessTokenError":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/CalendarAccountAccessTokenErrorCodeEnum"},"message":{"type":"string"}},"required":["code","message"]},"CalendarAccountAccessTokenErrorCodeEnum":{"enum":["no_oauth_credentials","bad_refresh_token","error"],"type":"string","description":"* `no_oauth_credentials` - no_oauth_credentials\n* `bad_refresh_token` - bad_refresh_token\n* `error` - error"},"CalendarAuthenticateRequestRequest":{"type":"object","properties":{"user_id":{"type":"string","minLength":1,"description":"The unique id of the user in your system."}},"required":["user_id"]},"CalendarAuthenticateResponse":{"type":"object","description":"Serializer for calendar authentication token response.","properties":{"token":{"type":"string","description":"The authentication token for the user."}},"required":["token"]},"CalendarEvent":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"start_time":{"type":"string","format":"date-time","readOnly":true},"end_time":{"type":"string","format":"date-time","readOnly":true},"calendar_id":{"type":"string","format":"uuid","readOnly":true},"raw":{"readOnly":true,"description":"The raw calendar event data from the calendar provider. The schema depends on the platform:\n\n- **Google Calendar**: [Event resource](https://developers.google.com/workspace/calendar/api/v3/reference/events#resource)\n- **Microsoft Outlook**: [Event resource](https://learn.microsoft.com/en-us/graph/api/resources/event?view=graph-rest-1.0#properties)"},"platform":{"type":"string","readOnly":true},"platform_id":{"type":"string","readOnly":true},"ical_uid":{"type":"string","readOnly":true},"meeting_platform":{"nullable":true,"readOnly":true,"allOf":[{"$ref":"#/components/schemas/MeetingPlatformEnum"}]},"meeting_url":{"type":"string","readOnly":true,"nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true},"is_deleted":{"type":"boolean","readOnly":true},"bots":{"type":"array","items":{"$ref":"#/components/schemas/CalendarEventBot"},"readOnly":true}},"required":["bots","calendar_id","created_at","end_time","ical_uid","id","is_deleted","meeting_platform","meeting_url","platform","platform_id","raw","start_time","updated_at"]},"CalendarEventAddBotConfigSchemaRequest":{"type":"object","properties":{"meeting_url":{"type":"string","description":"The url of the meeting. For example, https://zoom.us/j/123?pwd=456. If not specified, the meeting URL from the calendar event will be used."},"bot_name":{"type":"string","minLength":1,"default":"Meeting Notetaker","description":"The name of the bot that will be displayed in the call.\n*(Note: Authenticated Google Meet bots will use the Google account name and this field will be ignored.)*","maxLength":100},"join_at":{"type":"string","format":"date-time","nullable":true,"description":"The time at which the bot will join the call, formatted in ISO 8601. If not specified, the start time from the calendar event will be used."},"recording_config":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRequest"}],"nullable":true,"description":"Configure the recording generated by the bot. Includes options for getting meeting transcript,  the layout of the recorded video, when to start recording and more."},"output_media":{"allOf":[{"$ref":"#/components/schemas/OutputMediaRequest"}],"nullable":true,"description":"Settings for the bot output media."},"automatic_video_output":{"allOf":[{"$ref":"#/components/schemas/AutomaticVideoOutputRequest"}],"nullable":true,"description":"Settings for the bot to output video. Image should be 16:9. Read more about this here: https://docs.recall.ai/docs/output-video-in-meetings"},"automatic_audio_output":{"allOf":[{"$ref":"#/components/schemas/AutomaticAudioOutputRequest"}],"nullable":true,"description":"Settings for the bot to output audio."},"chat":{"allOf":[{"$ref":"#/components/schemas/ChatRequest"}],"nullable":true,"description":"Settings for the bot to send chat messages. \n*(Note: Chat functionality is only supported for Zoom, Google Meet and Microsoft Teams currently.)*"},"automatic_leave":{"allOf":[{"$ref":"#/components/schemas/AutomaticLeaveRequest"}],"nullable":true},"variant":{"allOf":[{"$ref":"#/components/schemas/BotVariantRequest"}],"nullable":true,"description":"Configure bot variants per meeting platforms, e.g. {\"zoom\": \"web_4_core\"}."},"zoom":{"allOf":[{"$ref":"#/components/schemas/ZoomRequest"}],"nullable":true,"description":"Zoom specific parameters"},"google_meet":{"allOf":[{"$ref":"#/components/schemas/GoogleMeetRequest"}],"nullable":true,"description":"Google Meet specific parameters"},"webex":{"allOf":[{"$ref":"#/components/schemas/WebexRequest"}],"nullable":true,"description":"Webex specific parameters"},"breakout_room":{"allOf":[{"$ref":"#/components/schemas/_BreakoutRoomSchemaRequest"}],"nullable":true,"description":"Configure how the bot handles breakout rooms. Currently, Zoom is supported.Examples: {\"mode\": \"join_main_room\"} | {\"mode\": \"join_specific_room\", \"room_id\": \"<uuid>\"} | {\"mode\": \"auto_accept_all_invites\"} (default)."},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"CalendarEventAddBotRequest":{"type":"object","properties":{"deduplication_key":{"type":"string","writeOnly":true,"minLength":1,"description":"Pass this key to deduplicate bots across multiple calendar events. Please ensure this remains consistent across all calendar events that must share a single bot. For more details, refer to Calendar V2 scheduling guide.","maxLength":2000},"bot_config":{"allOf":[{"$ref":"#/components/schemas/CalendarEventAddBotConfigSchemaRequest"}],"writeOnly":true,"description":"The config object(JSON) to be passed to the bot. It supports all properties available in **[Create Bot request. ](https://docs.recall.ai/reference/bot_create)**\n\n`meeting_url` - automatically populated from the calendar event unless specified in bot_config.\n`join_at` - automatically populated from the calendar event"}},"required":["bot_config","deduplication_key"]},"CalendarEventBot":{"type":"object","properties":{"bot_id":{"type":"string","format":"uuid","readOnly":true},"start_time":{"type":"string","format":"date-time","readOnly":true},"deduplication_key":{"type":"string","readOnly":true},"meeting_url":{"type":"string","readOnly":true}},"required":["bot_id","deduplication_key","meeting_url","start_time"]},"CalendarMeeting":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"override_should_record":{"type":"boolean","nullable":true},"title":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"will_record":{"type":"boolean","readOnly":true},"will_record_reason":{"type":"string","readOnly":true},"start_time":{"type":"string","format":"date-time","readOnly":true},"end_time":{"type":"string","format":"date-time","readOnly":true},"platform":{"type":"string","readOnly":true},"platform_id":{"type":"string","readOnly":true},"meeting_platform":{"type":"string","readOnly":true},"calendar_platform":{"type":"string","readOnly":true},"zoom_invite":{"allOf":[{"$ref":"#/components/schemas/ZoomMeetingInvite"}],"readOnly":true},"teams_invite":{"allOf":[{"$ref":"#/components/schemas/TeamsMeetingInvite"}],"readOnly":true},"meet_invite":{"allOf":[{"$ref":"#/components/schemas/GmeetMeetingInvite"}],"readOnly":true},"webex_invite":{"allOf":[{"$ref":"#/components/schemas/WebexInvite"}],"readOnly":true},"goto_meeting_invite":{"allOf":[{"$ref":"#/components/schemas/GotoMeetingInvite"}],"readOnly":true},"bot_id":{"type":"string","format":"uuid","nullable":true,"readOnly":true},"is_external":{"type":"boolean","readOnly":true},"is_hosted_by_me":{"type":"boolean","readOnly":true},"is_recurring":{"type":"boolean","readOnly":true},"organizer_email":{"type":"string","readOnly":true},"attendee_emails":{"type":"array","items":{"type":"string"},"readOnly":true},"attendees":{"type":"array","items":{"$ref":"#/components/schemas/MeetingAttendee"},"readOnly":true},"ical_uid":{"type":"string","readOnly":true},"visibility":{"type":"string","readOnly":true,"description":"\n            For Google calendar meetings('default' | 'public' | 'private' | 'confidential').\n            For Microsoft Outlook('normal' | 'personal' | 'private' | 'confidential').\n            Additionally, this field may contain 'null' value.\n        "}},"required":["attendee_emails","attendees","bot_id","calendar_platform","description","end_time","goto_meeting_invite","ical_uid","id","is_external","is_hosted_by_me","is_recurring","meet_invite","meeting_platform","organizer_email","platform","platform_id","start_time","teams_invite","title","visibility","webex_invite","will_record","will_record_reason","zoom_invite"]},"CalendarMeetingRequest":{"type":"object","properties":{"override_should_record":{"type":"boolean","nullable":true}}},"CalendarPlatformEnum":{"enum":["google_calendar","microsoft_outlook"],"type":"string","description":"* `google_calendar` - Google Calendar\n* `microsoft_outlook` - Microsoft Outlook"},"CalendarRecordingPreferences":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"record_non_host":{"type":"boolean"},"record_recurring":{"type":"boolean"},"record_external":{"type":"boolean"},"record_internal":{"type":"boolean"},"record_confirmed":{"type":"boolean"},"record_only_host":{"type":"boolean"},"bot_name":{"type":"string"}},"required":["id"]},"CalendarRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}},"oauth_client_id":{"type":"string","minLength":1,"maxLength":2000},"oauth_client_secret":{"type":"string","minLength":1,"maxLength":2000},"oauth_refresh_token":{"type":"string","minLength":1,"maxLength":10000},"platform":{"$ref":"#/components/schemas/CalendarPlatformEnum"},"webhook_url":{"type":"string","format":"uri","minLength":1,"maxLength":2000,"deprecated":true},"oauth_email":{"type":"string","format":"email","minLength":1,"maxLength":2000}},"required":["oauth_client_id","oauth_client_secret","oauth_refresh_token","platform"]},"CalendarStatusChange":{"type":"object","properties":{"status":{"allOf":[{"$ref":"#/components/schemas/CalendarStatusChangeStatusEnum"}],"readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"reason":{"type":"string","readOnly":true}},"required":["created_at","reason","status"]},"CalendarStatusChangeStatusEnum":{"enum":["connecting","connected","disconnected"],"type":"string","description":"* `connecting` - Connecting\n* `connected` - Connected\n* `disconnected` - Disconnected"},"CalendarUser":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"external_id":{"type":"string"},"connections":{"type":"array","items":{"$ref":"#/components/schemas/CalendarUserConnection"},"readOnly":true},"preferences":{"$ref":"#/components/schemas/CalendarRecordingPreferences"}},"required":["connections","id"]},"CalendarUserConnection":{"type":"object","properties":{"connected":{"type":"boolean"},"platform":{"type":"string"},"email":{"type":"string"},"id":{"type":"string"}},"required":["connected","platform"]},"CalendarUserDisconnectPlatformPlatformEnum":{"enum":["google","microsoft"],"type":"string","description":"* `google` - Google\n* `microsoft` - Microsoft"},"CalendarUserDisconnectPlatformRequest":{"type":"object","properties":{"platform":{"allOf":[{"$ref":"#/components/schemas/CalendarUserDisconnectPlatformPlatformEnum"}],"description":"The platform to disconnect. ('google' or 'microsoft')\n\n* `google` - Google\n* `microsoft` - Microsoft"}},"required":["platform"]},"CalendarUserRequest":{"type":"object","properties":{"external_id":{"type":"string","minLength":1},"preferences":{"$ref":"#/components/schemas/PatchedCalendarRecordingPreferencesRequest"}}},"Chat":{"type":"object","properties":{"on_bot_join":{"$ref":"#/components/schemas/ChatOnBotJoin"},"on_participant_join":{"$ref":"#/components/schemas/ChatOnParticipantJoin"}}},"ChatOnBotJoin":{"type":"object","properties":{"send_to":{"$ref":"#/components/schemas/SendToEnum"},"message":{"type":"string","maxLength":4096},"pin":{"type":"boolean","default":false,"description":"Pin message after sending. Only Google Meet and Microsoft Teams are supported at this time"}},"required":["message","send_to"]},"ChatOnBotJoinRequest":{"type":"object","properties":{"send_to":{"$ref":"#/components/schemas/SendToEnum"},"message":{"type":"string","minLength":1,"maxLength":4096},"pin":{"type":"boolean","default":false,"description":"Pin message after sending. Only Google Meet and Microsoft Teams are supported at this time"}},"required":["message","send_to"]},"ChatOnParticipantJoin":{"type":"object","properties":{"message":{"type":"string","maxLength":4096},"exclude_host":{"type":"boolean"}},"required":["exclude_host","message"]},"ChatOnParticipantJoinRequest":{"type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":4096},"exclude_host":{"type":"boolean"}},"required":["exclude_host","message"]},"ChatRequest":{"type":"object","properties":{"on_bot_join":{"$ref":"#/components/schemas/ChatOnBotJoinRequest"},"on_participant_join":{"$ref":"#/components/schemas/ChatOnParticipantJoinRequest"}}},"DebounceModeEnum":{"enum":["leading","trailing"],"type":"string","description":"* `leading` - leading\n* `trailing` - trailing"},"DesktopSdkRecordingConfig":{"type":"object","properties":{"video_mixed_mp4":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"default":{},"description":"Capture mixed video of the meeting as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"audio_mixed_mp3":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Capture mixed audio of the meeting in mp3 format as an independent artifact.\n\nDefault: `null`\n\n"},"participant_events":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"default":{},"description":"Capture participant events as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"video_mixed_participant_video_when_screenshare":{"allOf":[{"$ref":"#/components/schemas/VideoMixedParticipantVideoWhenScreenshareEnum"}],"default":"overlap","description":"The layout of participant video streams in mixed video output when screen is being shared. More docs: https://docs.recall.ai/docs/video-layouts\n\n* `hide` - hide\n* `beside` - beside\n* `overlap` - overlap"},"transcript":{"allOf":[{"$ref":"#/components/schemas/DesktopSdkTranscriptArtifact"}],"nullable":true,"description":"Specify this to capture transcript of the meeting as part of the recording. **[Read more in this guide](https://docs.recall.ai/docs/bot-real-time-transcription)**\n\nDefault: `null`\n\n"},"realtime_endpoints":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpoint"},"default":[],"description":"Add endpoints here to receive data (e.g transcript, participant events) from the recording in realtime during the meeting.\n\nDefault: `[]`\n\n"},"retention":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetention"}],"nullable":true,"description":"Specify the retention policy for the recording. The DSDK does not currently support Zero Data Retention. **[Read more in this guide](https://docs.recall.ai/docs/storage-and-playback)**"},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"DesktopSdkRecordingConfigRequest":{"type":"object","properties":{"video_mixed_mp4":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"default":{},"description":"Capture mixed video of the meeting as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"audio_mixed_mp3":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Capture mixed audio of the meeting in mp3 format as an independent artifact.\n\nDefault: `null`\n\n"},"participant_events":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"default":{},"description":"Capture participant events as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"video_mixed_participant_video_when_screenshare":{"allOf":[{"$ref":"#/components/schemas/VideoMixedParticipantVideoWhenScreenshareEnum"}],"default":"overlap","description":"The layout of participant video streams in mixed video output when screen is being shared. More docs: https://docs.recall.ai/docs/video-layouts\n\n* `hide` - hide\n* `beside` - beside\n* `overlap` - overlap"},"transcript":{"allOf":[{"$ref":"#/components/schemas/DesktopSdkTranscriptArtifactRequest"}],"nullable":true,"description":"Specify this to capture transcript of the meeting as part of the recording. **[Read more in this guide](https://docs.recall.ai/docs/bot-real-time-transcription)**\n\nDefault: `null`\n\n"},"realtime_endpoints":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointRequest"},"default":[],"description":"Add endpoints here to receive data (e.g transcript, participant events) from the recording in realtime during the meeting.\n\nDefault: `[]`\n\n"},"retention":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetentionRequest"}],"nullable":true,"description":"Specify the retention policy for the recording. The DSDK does not currently support Zero Data Retention. **[Read more in this guide](https://docs.recall.ai/docs/storage-and-playback)**"},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"DesktopSdkTranscriptArtifact":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}},"provider":{"$ref":"#/components/schemas/DesktopSdkTranscriptProvider"}},"required":["provider"]},"DesktopSdkTranscriptArtifactRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}},"provider":{"$ref":"#/components/schemas/DesktopSdkTranscriptProviderRequest"}},"required":["provider"]},"DesktopSdkTranscriptProvider":{"type":"object","properties":{"recallai_streaming":{"type":"object","title":"RecallAI Real-time Transcription Settings","description":" **[Read more in this guide](https://docs.recall.ai/docs/recallai-transcription)**"},"assembly_ai_v3_streaming":{"type":"object","properties":{"speech_model":{"description":"The speech model used for your Streaming session.","enum":["universal-streaming-english","universal-streaming-multilingual","whisper-rt","u3-rt-pro"]},"format_turns":{"description":"Whether to return formatted final transcripts.","default":false,"type":"boolean"},"inactivity_timeout":{"description":"Optional time in seconds of inactivity before session is terminated. If not set, no inactivity timeout is applied.","default":"None","format":"s","type":"integer","minimum":5,"maximum":3600},"keyterms_prompt":{"description":"A list of words and phrases to improve recognition accuracy for. See [Keyterms Prompting](https://www.assemblyai.com/docs/streaming/keyterms-prompting) for more details.","type":"array","items":{"x-label":"Word","type":"string"}},"language_detection":{"description":"Whether to detect the language and return language metadata on utterances and final turns. Only available for the multilingual model.","enum":["true","false"],"default":"false"},"max_turn_silence":{"description":"The maximum amount of silence in milliseconds allowed in a turn before end of turn is triggered. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","type":"integer","default":1280},"min_turn_silence":{"description":"The minimum amount of silence in milliseconds required to detect end of turn when confident. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","type":"integer","default":400},"vad_threshold":{"description":"The confidence threshold (0.0 to 1.0) for classifying audio frames as silence. Frames with VAD confidence below this value are considered silent. Increase for noisy environments to reduce false speech detection.","default":0.4,"type":"number"},"end_of_turn_confidence_threshold":{"description":"The confidence threshold (0.0 to 1.0) to use when determining if the end of a turn has been reached. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","deprecated":true,"type":"number","default":0.4},"language":{"description":"The language of your audio stream.","enum":["en","multi"],"default":"en","deprecated":true}},"title":"AssemblyAi Real-time Transcription Settings","description":"Docs: https://www.assemblyai.com/docs/api-reference/streaming-api/streaming-api"},"deepgram_streaming":{"type":"object","properties":{"diarize":{"description":"Defaults to `false`. Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0","default":"false","enum":["true","false"]},"dictation":{"description":"Identify and extract key entities from content in submitted audio","default":"false","enum":["true","false"]},"endpointing":{"description":"Indicates how long Deepgram will wait to detect whether a speaker has finished speaking or pauses for a significant period of time. When set to a value, the streaming endpoint immediately finalizes the transcription for the processed time range and returns the transcript with a speech_final parameter set to true. Can also be set to false to disable endpointing","default":"10"},"extra":{"description":"Arbitrary key-value pairs that are attached to the API response for usage in downstream processing"},"filler_words":{"description":"Filler Words can help transcribe interruptions in your audio, like \"uh\" and \"um\"","default":"false","enum":["true","false"]},"interim_results":{"description":"Specifies whether the streaming endpoint should provide ongoing transcription updates as more audio is received. When set to true, the endpoint sends continuous updates, meaning transcription results may evolve over time","default":"false","enum":["true","false"]},"keyterm":{"description":"Key term prompting can boost or suppress specialized terminology and brands. Only compatible with Nova-3"},"keywords":{"description":"Keywords can boost or suppress specialized terminology and brands"},"language":{"description":"The [BCP-47 language tag](https://tools.ietf.org/html/bcp47) that hints at the primary spoken language. Depending on the Model you choose only certain languages are available","default":"en","enum":["bg","ca","cs","da","da-DK","de","de-CH","el","en","en-AU","en-GB","en-IN","en-NZ","en-US","es","es-419","es-LATAM","et","fi","fr","fr-CA","hi","hi-Latn","hu","id","it","ja","ko","ko-KR","lt","lv","ms","multi","nl","nl-BE","no","pl","pt","pt-BR","pt-PT","ro","ru","sk","sv","sv-SE","taq","th","th-TH","tr","uk","vi","zh","zh-CN","zh-HK","zh-Hans","zh-Hant","zh-TW"]},"mip_opt_out":{"description":"Opts out requests from the Deepgram Model Improvement Program. Refer to our Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mip","default":"false"},"model":{"description":"AI model to use for the transcription","enum":["nova-3","nova-3-general","nova-3-medical","nova-2","nova-2-general","nova-2-meeting","nova-2-finance","nova-2-conversationalai","nova-2-voicemail","nova-2-video","nova-2-medical","nova-2-drivethru","nova-2-automotive","nova","nova-general","nova-phonecall","nova-medical","enhanced","enhanced-general","enhanced-meeting","enhanced-phonecall","enhanced-finance","base","meeting","phonecall","finance","conversationalai","voicemail","video","custom"]},"multichannel":{"description":"Transcribe each audio channel independently","default":"false","enum":["true","false"]},"numerals":{"description":"Convert numbers from written format to numerical format","default":"false","enum":["true","false"]},"profanity_filter":{"description":"Profanity Filter looks for recognized profanity and converts it to the nearest recognized non-profane word or removes it from the transcript completely","default":"false","enum":["true","false"]},"punctuate":{"description":"Add punctuation and capitalization to the transcript","default":"false","enum":["true","false"]},"redact":{"description":"Redaction removes sensitive information from your transcripts","default":"false","enum":["true","false","pci","numbers","aggressive_numbers","ssn"]},"replace":{"description":"Search for terms or phrases in submitted audio and replaces them"},"search":{"description":"Search for terms or phrases in submitted audio"},"smart_format":{"description":"Apply formatting to transcript output. When set to true, additional formatting will be applied to transcripts to improve readability","default":"false","enum":["true","false"]},"tag":{"description":"Label your requests for the purpose of identification during usage reporting"},"utterance_end_ms":{"description":"Indicates how long Deepgram will wait to send an UtteranceEnd message after a word has been transcribed. Use with interim_results"},"vad_events":{"description":"Indicates that speech has started. You'll begin receiving Speech Started messages upon speech starting","default":"false","enum":["true","false"]},"version":{"description":"Version of an AI model to use","default":"latest"}},"title":"Deepgram Real-time Transcription Settings","description":"Docs: https://developers.deepgram.com/reference/streaming"},"gladia_v2_streaming":{"type":"object","properties":{"custom_metadata":{"type":"object","description":"Custom metadata you can attach to this live transcription","example":{"user":"John Doe"}},"model":{"type":"string","description":"The model used to process the audio. \"solaria-1\" is used by default.","default":"solaria-1","enum":["solaria-1"]},"endpointing":{"type":"number","description":"The endpointing duration in seconds. Endpointing is the duration of silence which will cause an utterance to be considered as finished","default":0.05,"minimum":0.01,"maximum":10},"maximum_duration_without_endpointing":{"type":"number","description":"The maximum duration in seconds without endpointing. If endpointing is not detected after this duration, current utterance will be considered as finished","default":5,"minimum":5,"maximum":60},"language_config":{"properties":{"languages":{"type":"array","description":"If one language is set, it will be used for the transcription. Otherwise, language will be auto-detected by the model.","default":[],"items":{"type":"string","enum":["af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","ca","zh","hr","cs","da","nl","en","et","fo","fi","fr","gl","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","id","it","ja","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","mymr","ne","no","nn","oc","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","jp"]}},"code_switching":{"type":"boolean","description":"If true, language will be auto-detected on each utterance. Otherwise, language will be auto-detected on first utterance and then used for the rest of the transcription. If one language is set, this option will be ignored.","default":false}},"type":"object","description":"Specify the language configuration"},"pre_processing":{"properties":{"audio_enhancer":{"type":"boolean","description":"If true, apply pre-processing to the audio stream to enhance the quality.","default":false},"speech_threshold":{"type":"number","description":"Sensitivity configuration for Speech Threshold. A value close to 1 will apply stricter thresholds, making it less likely to detect background sounds as speech.","default":0.6,"minimum":0,"maximum":1}},"type":"object","description":"Specify the pre-processing configuration"},"realtime_processing":{"properties":{"custom_vocabulary":{"type":"boolean","description":"If true, enable custom vocabulary for the transcription.","default":false},"custom_vocabulary_config":{"properties":{"vocabulary":{"description":"Specific vocabulary list to feed the transcription model with. Each item can be a string or an object with the following properties: value, intensity, pronunciations, language.","example":["Westeros",{"value":"Stark"},{"value":"Night's Watch","pronunciations":["Nightz Watch"],"intensity":0.4,"language":"en"}],"type":"array","items":{"oneOf":[{"type":"object","properties":{"value":{"type":"string","description":"The text used to replace in the transcription.","example":"Gladia"},"intensity":{"type":"number","description":"The global intensity of the feature.","example":0.5,"minimum":0,"maximum":1},"pronunciations":{"description":"The pronunciations used in the transcription.","type":"array","items":{"type":"string"}},"language":{"type":"string","description":"Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.","example":"en"}},"required":["value"]},{"type":"string"}]}},"default_intensity":{"type":"number","description":"Default intensity for the custom vocabulary","example":0.5,"minimum":0,"maximum":1}},"required":["vocabulary"],"type":"object","description":"Custom vocabulary configuration, if `custom_vocabulary` is enabled"},"custom_spelling":{"type":"boolean","description":"If true, enable custom spelling for the transcription.","default":false},"custom_spelling_config":{"properties":{"spelling_dictionary":{"type":"object","description":"The list of spelling applied on the audio transcription","example":{"Gettleman":["gettleman"],"SQL":["Sequel"]}}},"required":["spelling_dictionary"],"type":"object","description":"Custom spelling configuration, if `custom_spelling` is enabled"},"translation":{"type":"boolean","description":"If true, enable translation for the transcription","default":false},"translation_config":{"properties":{"target_languages":{"type":"array","example":["en"],"minItems":1,"items":{"type":"string","description":"The target language in `iso639-1` format","enum":["af","sq","am","ar","hy","as","ast","az","ba","eu","be","bn","bs","br","bg","my","ca","ceb","zh","hr","cs","da","nl","en","et","fo","fi","nl","fr","fy","ff","gd","gl","lg","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","ig","ilo","id","ga","it","ja","jp","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mo","mn","mymr","ne","no","nn","oc","or","pa","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","ss","sv","tl","tg","ta","tt","te","th","bo","tn","tr","tk","uk","ur","uz","vi","cy","wo","xh","yi","yo","zu"]}},"model":{"type":"string","description":"Model you want the translation model to use to translate","default":"base","enum":["base","enhanced"]},"match_original_utterances":{"type":"boolean","description":"Align translated utterances with the original ones","default":true},"lipsync":{"type":"boolean","description":"Whether to apply lipsync to the translated transcription. ","default":true},"context_adaptation":{"type":"boolean","description":"Enables or disables context-aware translation features that allow the model to adapt translations based on provided context.","default":true},"context":{"type":"string","description":"Context information to improve translation accuracy"},"informal":{"type":"boolean","description":"Forces the translation to use informal language forms when available in the target language.","default":false}},"required":["target_languages"],"type":"object","description":"Translation configuration, if `translation` is enabled"},"named_entity_recognition":{"type":"boolean","description":"If true, enable named entity recognition for the transcription.","default":false},"sentiment_analysis":{"type":"boolean","description":"If true, enable sentiment analysis for the transcription.","default":false}},"type":"object","description":"Specify the realtime processing configuration"},"post_processing":{"properties":{"summarization":{"type":"boolean","description":"If true, generates summarization for the whole transcription.","default":false},"summarization_config":{"properties":{"type":{"type":"string","description":"The type of summarization to apply","default":"general","enum":["general","bullet_points","concise"]}},"type":"object","description":"Summarization configuration, if `summarization` is enabled"},"chapterization":{"type":"boolean","description":"If true, generates chapters for the whole transcription.","default":false}},"type":"object","description":"Specify the post-processing configuration"},"messages_config":{"properties":{"receive_final_transcripts":{"type":"boolean","description":"If true, final utterance will be sent to websocket.","default":true},"receive_speech_events":{"type":"boolean","description":"If true, begin and end speech events will be sent to websocket.","default":true},"receive_pre_processing_events":{"type":"boolean","description":"If true, pre-processing events will be sent to websocket.","default":true},"receive_realtime_processing_events":{"type":"boolean","description":"If true, realtime processing events will be sent to websocket.","default":true},"receive_post_processing_events":{"type":"boolean","description":"If true, post-processing events will be sent to websocket.","default":true},"receive_acknowledgments":{"type":"boolean","description":"If true, acknowledgments will be sent to websocket.","default":true},"receive_errors":{"type":"boolean","description":"If true, errors will be sent to websocket.","default":true},"receive_lifecycle_events":{"type":"boolean","description":"If true, lifecycle events will be sent to websocket.","default":false}},"type":"object","description":"Specify the websocket messages configuration"},"callback":{"type":"boolean","description":"If true, messages will be sent to configured url.","default":false},"callback_config":{"properties":{"url":{"type":"string","description":"URL on which we will do a `POST` request with configured messages","example":"https://callback.example","format":"uri"},"receive_final_transcripts":{"type":"boolean","description":"If true, final utterance will be sent to the defined callback.","default":true},"receive_speech_events":{"type":"boolean","description":"If true, begin and end speech events will be sent to the defined callback.","default":false},"receive_pre_processing_events":{"type":"boolean","description":"If true, pre-processing events will be sent to the defined callback.","default":true},"receive_realtime_processing_events":{"type":"boolean","description":"If true, realtime processing events will be sent to the defined callback.","default":true},"receive_post_processing_events":{"type":"boolean","description":"If true, post-processing events will be sent to the defined callback.","default":true},"receive_acknowledgments":{"type":"boolean","description":"If true, acknowledgments will be sent to the defined callback.","default":false},"receive_errors":{"type":"boolean","description":"If true, errors will be sent to the defined callback.","default":false},"receive_lifecycle_events":{"type":"boolean","description":"If true, lifecycle events will be sent to the defined callback.","default":true}},"type":"object","description":"Specify the callback configuration"}},"title":"Gladia Real-time Transcription Settings","description":"Docs: https://docs.gladia.io/reference/live-audio"},"speechmatics_streaming":{"type":"object","properties":{"language":{"type":"string"},"domain":{"type":"string","description":"Request a specialized model based on 'language' but optimized for a particular field, e.g. \"finance\" or \"medical\"."},"output_locale":{"type":"string","minLength":1},"additional_vocab":{"type":"array","items":{"type":"object","oneOf":[{"type":"string","minLength":1},{"type":"object","properties":{"content":{"type":"string","minLength":1},"sounds_like":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["content"]}]}},"diarization":{"type":"string","enum":["none","speaker"]},"max_delay":{"type":"number","minimum":0},"max_delay_mode":{"type":"string","enum":["flexible","fixed"]},"speaker_diarization_config":{"type":"object","properties":{"max_speakers":{"type":"number","format":"integer","minimum":2,"maximum":100},"prefer_current_speaker":{"type":"boolean"},"speaker_sensitivity":{"type":"number","format":"float","minimum":0,"maximum":1}}},"audio_filtering_config":{"type":"object","properties":{"volume_threshold":{"type":"number","format":"float","minimum":0,"maximum":100}}},"transcript_filtering_config":{"type":"object","properties":{"remove_disfluencies":{"type":"boolean"},"replacements":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"]}}}},"enable_partials":{"type":"boolean","default":false},"enable_entities":{"type":"boolean","default":true},"operating_point":{"type":"string","enum":["standard","enhanced"]},"punctuation_overrides":{"type":"object","properties":{"permitted_marks":{"type":"array","description":"The punctuation marks which the client is prepared to accept in transcription output, or the special value 'all' (the default). Unsupported marks are ignored. This value is used to guide the transcription process.","items":{"pattern":"^(.|all)$","type":"string"}},"sensitivity":{"type":"number","description":"Ranges between zero and one. Higher values will produce more punctuation. The default is 0.5.","format":"float","maximum":1,"minimum":0}}},"conversation_config":{"type":"object","properties":{"end_of_utterance_silence_trigger":{"type":"number","format":"float","minimum":0,"maximum":2,"default":0}},"description":"This mode will detect when a speaker has stopped talking. The end_of_utterance_silence_trigger is the time in seconds after which the server will assume that the speaker has finished speaking, and will emit an EndOfUtterance message. A value of 0 disables the feature."}},"required":["language"],"title":"Speechmatics Real-time Transcription Settings","description":"You must specify `language` (e.g `en`)\n\nDocs: https://docs.speechmatics.com/rt-api-ref#transcription-config"},"elevenlabs_streaming":{"type":"object","properties":{"model_id":{"description":"The model to use for transcription.","type":"string","default":"eleven_whisper_v2_realtime"},"language_code":{"description":"ISO 639-1 two-letter language code. When not specified, the model auto-detects the language.","type":"string"},"previous_text":{"description":"Text from a previous transcription session to provide context for the model. Sent in the first message to the WebSocket.","type":"string"}},"title":"ElevenLabs Real-time Transcription Settings","description":"Docs: https://elevenlabs.io/docs/api-reference/speech-to-text"}}},"DesktopSdkTranscriptProviderRequest":{"type":"object","properties":{"recallai_streaming":{"type":"object","title":"RecallAI Real-time Transcription Settings","description":" **[Read more in this guide](https://docs.recall.ai/docs/recallai-transcription)**"},"assembly_ai_v3_streaming":{"type":"object","properties":{"speech_model":{"description":"The speech model used for your Streaming session.","enum":["universal-streaming-english","universal-streaming-multilingual","whisper-rt","u3-rt-pro"]},"format_turns":{"description":"Whether to return formatted final transcripts.","default":false,"type":"boolean"},"inactivity_timeout":{"description":"Optional time in seconds of inactivity before session is terminated. If not set, no inactivity timeout is applied.","default":"None","format":"s","type":"integer","minimum":5,"maximum":3600},"keyterms_prompt":{"description":"A list of words and phrases to improve recognition accuracy for. See [Keyterms Prompting](https://www.assemblyai.com/docs/streaming/keyterms-prompting) for more details.","type":"array","items":{"x-label":"Word","type":"string"}},"language_detection":{"description":"Whether to detect the language and return language metadata on utterances and final turns. Only available for the multilingual model.","enum":["true","false"],"default":"false"},"max_turn_silence":{"description":"The maximum amount of silence in milliseconds allowed in a turn before end of turn is triggered. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","type":"integer","default":1280},"min_turn_silence":{"description":"The minimum amount of silence in milliseconds required to detect end of turn when confident. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","type":"integer","default":400},"vad_threshold":{"description":"The confidence threshold (0.0 to 1.0) for classifying audio frames as silence. Frames with VAD confidence below this value are considered silent. Increase for noisy environments to reduce false speech detection.","default":0.4,"type":"number"},"end_of_turn_confidence_threshold":{"description":"The confidence threshold (0.0 to 1.0) to use when determining if the end of a turn has been reached. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","deprecated":true,"type":"number","default":0.4},"language":{"description":"The language of your audio stream.","enum":["en","multi"],"default":"en","deprecated":true}},"title":"AssemblyAi Real-time Transcription Settings","description":"Docs: https://www.assemblyai.com/docs/api-reference/streaming-api/streaming-api"},"deepgram_streaming":{"type":"object","properties":{"diarize":{"description":"Defaults to `false`. Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0","default":"false","enum":["true","false"]},"dictation":{"description":"Identify and extract key entities from content in submitted audio","default":"false","enum":["true","false"]},"endpointing":{"description":"Indicates how long Deepgram will wait to detect whether a speaker has finished speaking or pauses for a significant period of time. When set to a value, the streaming endpoint immediately finalizes the transcription for the processed time range and returns the transcript with a speech_final parameter set to true. Can also be set to false to disable endpointing","default":"10"},"extra":{"description":"Arbitrary key-value pairs that are attached to the API response for usage in downstream processing"},"filler_words":{"description":"Filler Words can help transcribe interruptions in your audio, like \"uh\" and \"um\"","default":"false","enum":["true","false"]},"interim_results":{"description":"Specifies whether the streaming endpoint should provide ongoing transcription updates as more audio is received. When set to true, the endpoint sends continuous updates, meaning transcription results may evolve over time","default":"false","enum":["true","false"]},"keyterm":{"description":"Key term prompting can boost or suppress specialized terminology and brands. Only compatible with Nova-3"},"keywords":{"description":"Keywords can boost or suppress specialized terminology and brands"},"language":{"description":"The [BCP-47 language tag](https://tools.ietf.org/html/bcp47) that hints at the primary spoken language. Depending on the Model you choose only certain languages are available","default":"en","enum":["bg","ca","cs","da","da-DK","de","de-CH","el","en","en-AU","en-GB","en-IN","en-NZ","en-US","es","es-419","es-LATAM","et","fi","fr","fr-CA","hi","hi-Latn","hu","id","it","ja","ko","ko-KR","lt","lv","ms","multi","nl","nl-BE","no","pl","pt","pt-BR","pt-PT","ro","ru","sk","sv","sv-SE","taq","th","th-TH","tr","uk","vi","zh","zh-CN","zh-HK","zh-Hans","zh-Hant","zh-TW"]},"mip_opt_out":{"description":"Opts out requests from the Deepgram Model Improvement Program. Refer to our Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mip","default":"false"},"model":{"description":"AI model to use for the transcription","enum":["nova-3","nova-3-general","nova-3-medical","nova-2","nova-2-general","nova-2-meeting","nova-2-finance","nova-2-conversationalai","nova-2-voicemail","nova-2-video","nova-2-medical","nova-2-drivethru","nova-2-automotive","nova","nova-general","nova-phonecall","nova-medical","enhanced","enhanced-general","enhanced-meeting","enhanced-phonecall","enhanced-finance","base","meeting","phonecall","finance","conversationalai","voicemail","video","custom"]},"multichannel":{"description":"Transcribe each audio channel independently","default":"false","enum":["true","false"]},"numerals":{"description":"Convert numbers from written format to numerical format","default":"false","enum":["true","false"]},"profanity_filter":{"description":"Profanity Filter looks for recognized profanity and converts it to the nearest recognized non-profane word or removes it from the transcript completely","default":"false","enum":["true","false"]},"punctuate":{"description":"Add punctuation and capitalization to the transcript","default":"false","enum":["true","false"]},"redact":{"description":"Redaction removes sensitive information from your transcripts","default":"false","enum":["true","false","pci","numbers","aggressive_numbers","ssn"]},"replace":{"description":"Search for terms or phrases in submitted audio and replaces them"},"search":{"description":"Search for terms or phrases in submitted audio"},"smart_format":{"description":"Apply formatting to transcript output. When set to true, additional formatting will be applied to transcripts to improve readability","default":"false","enum":["true","false"]},"tag":{"description":"Label your requests for the purpose of identification during usage reporting"},"utterance_end_ms":{"description":"Indicates how long Deepgram will wait to send an UtteranceEnd message after a word has been transcribed. Use with interim_results"},"vad_events":{"description":"Indicates that speech has started. You'll begin receiving Speech Started messages upon speech starting","default":"false","enum":["true","false"]},"version":{"description":"Version of an AI model to use","default":"latest"}},"title":"Deepgram Real-time Transcription Settings","description":"Docs: https://developers.deepgram.com/reference/streaming"},"gladia_v2_streaming":{"type":"object","properties":{"custom_metadata":{"type":"object","description":"Custom metadata you can attach to this live transcription","example":{"user":"John Doe"}},"model":{"type":"string","description":"The model used to process the audio. \"solaria-1\" is used by default.","default":"solaria-1","enum":["solaria-1"]},"endpointing":{"type":"number","description":"The endpointing duration in seconds. Endpointing is the duration of silence which will cause an utterance to be considered as finished","default":0.05,"minimum":0.01,"maximum":10},"maximum_duration_without_endpointing":{"type":"number","description":"The maximum duration in seconds without endpointing. If endpointing is not detected after this duration, current utterance will be considered as finished","default":5,"minimum":5,"maximum":60},"language_config":{"properties":{"languages":{"type":"array","description":"If one language is set, it will be used for the transcription. Otherwise, language will be auto-detected by the model.","default":[],"items":{"type":"string","enum":["af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","ca","zh","hr","cs","da","nl","en","et","fo","fi","fr","gl","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","id","it","ja","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","mymr","ne","no","nn","oc","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","jp"]}},"code_switching":{"type":"boolean","description":"If true, language will be auto-detected on each utterance. Otherwise, language will be auto-detected on first utterance and then used for the rest of the transcription. If one language is set, this option will be ignored.","default":false}},"type":"object","description":"Specify the language configuration"},"pre_processing":{"properties":{"audio_enhancer":{"type":"boolean","description":"If true, apply pre-processing to the audio stream to enhance the quality.","default":false},"speech_threshold":{"type":"number","description":"Sensitivity configuration for Speech Threshold. A value close to 1 will apply stricter thresholds, making it less likely to detect background sounds as speech.","default":0.6,"minimum":0,"maximum":1}},"type":"object","description":"Specify the pre-processing configuration"},"realtime_processing":{"properties":{"custom_vocabulary":{"type":"boolean","description":"If true, enable custom vocabulary for the transcription.","default":false},"custom_vocabulary_config":{"properties":{"vocabulary":{"description":"Specific vocabulary list to feed the transcription model with. Each item can be a string or an object with the following properties: value, intensity, pronunciations, language.","example":["Westeros",{"value":"Stark"},{"value":"Night's Watch","pronunciations":["Nightz Watch"],"intensity":0.4,"language":"en"}],"type":"array","items":{"oneOf":[{"type":"object","properties":{"value":{"type":"string","description":"The text used to replace in the transcription.","example":"Gladia"},"intensity":{"type":"number","description":"The global intensity of the feature.","example":0.5,"minimum":0,"maximum":1},"pronunciations":{"description":"The pronunciations used in the transcription.","type":"array","items":{"type":"string"}},"language":{"type":"string","description":"Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.","example":"en"}},"required":["value"]},{"type":"string"}]}},"default_intensity":{"type":"number","description":"Default intensity for the custom vocabulary","example":0.5,"minimum":0,"maximum":1}},"required":["vocabulary"],"type":"object","description":"Custom vocabulary configuration, if `custom_vocabulary` is enabled"},"custom_spelling":{"type":"boolean","description":"If true, enable custom spelling for the transcription.","default":false},"custom_spelling_config":{"properties":{"spelling_dictionary":{"type":"object","description":"The list of spelling applied on the audio transcription","example":{"Gettleman":["gettleman"],"SQL":["Sequel"]}}},"required":["spelling_dictionary"],"type":"object","description":"Custom spelling configuration, if `custom_spelling` is enabled"},"translation":{"type":"boolean","description":"If true, enable translation for the transcription","default":false},"translation_config":{"properties":{"target_languages":{"type":"array","example":["en"],"minItems":1,"items":{"type":"string","description":"The target language in `iso639-1` format","enum":["af","sq","am","ar","hy","as","ast","az","ba","eu","be","bn","bs","br","bg","my","ca","ceb","zh","hr","cs","da","nl","en","et","fo","fi","nl","fr","fy","ff","gd","gl","lg","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","ig","ilo","id","ga","it","ja","jp","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mo","mn","mymr","ne","no","nn","oc","or","pa","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","ss","sv","tl","tg","ta","tt","te","th","bo","tn","tr","tk","uk","ur","uz","vi","cy","wo","xh","yi","yo","zu"]}},"model":{"type":"string","description":"Model you want the translation model to use to translate","default":"base","enum":["base","enhanced"]},"match_original_utterances":{"type":"boolean","description":"Align translated utterances with the original ones","default":true},"lipsync":{"type":"boolean","description":"Whether to apply lipsync to the translated transcription. ","default":true},"context_adaptation":{"type":"boolean","description":"Enables or disables context-aware translation features that allow the model to adapt translations based on provided context.","default":true},"context":{"type":"string","description":"Context information to improve translation accuracy"},"informal":{"type":"boolean","description":"Forces the translation to use informal language forms when available in the target language.","default":false}},"required":["target_languages"],"type":"object","description":"Translation configuration, if `translation` is enabled"},"named_entity_recognition":{"type":"boolean","description":"If true, enable named entity recognition for the transcription.","default":false},"sentiment_analysis":{"type":"boolean","description":"If true, enable sentiment analysis for the transcription.","default":false}},"type":"object","description":"Specify the realtime processing configuration"},"post_processing":{"properties":{"summarization":{"type":"boolean","description":"If true, generates summarization for the whole transcription.","default":false},"summarization_config":{"properties":{"type":{"type":"string","description":"The type of summarization to apply","default":"general","enum":["general","bullet_points","concise"]}},"type":"object","description":"Summarization configuration, if `summarization` is enabled"},"chapterization":{"type":"boolean","description":"If true, generates chapters for the whole transcription.","default":false}},"type":"object","description":"Specify the post-processing configuration"},"messages_config":{"properties":{"receive_final_transcripts":{"type":"boolean","description":"If true, final utterance will be sent to websocket.","default":true},"receive_speech_events":{"type":"boolean","description":"If true, begin and end speech events will be sent to websocket.","default":true},"receive_pre_processing_events":{"type":"boolean","description":"If true, pre-processing events will be sent to websocket.","default":true},"receive_realtime_processing_events":{"type":"boolean","description":"If true, realtime processing events will be sent to websocket.","default":true},"receive_post_processing_events":{"type":"boolean","description":"If true, post-processing events will be sent to websocket.","default":true},"receive_acknowledgments":{"type":"boolean","description":"If true, acknowledgments will be sent to websocket.","default":true},"receive_errors":{"type":"boolean","description":"If true, errors will be sent to websocket.","default":true},"receive_lifecycle_events":{"type":"boolean","description":"If true, lifecycle events will be sent to websocket.","default":false}},"type":"object","description":"Specify the websocket messages configuration"},"callback":{"type":"boolean","description":"If true, messages will be sent to configured url.","default":false},"callback_config":{"properties":{"url":{"type":"string","description":"URL on which we will do a `POST` request with configured messages","example":"https://callback.example","format":"uri"},"receive_final_transcripts":{"type":"boolean","description":"If true, final utterance will be sent to the defined callback.","default":true},"receive_speech_events":{"type":"boolean","description":"If true, begin and end speech events will be sent to the defined callback.","default":false},"receive_pre_processing_events":{"type":"boolean","description":"If true, pre-processing events will be sent to the defined callback.","default":true},"receive_realtime_processing_events":{"type":"boolean","description":"If true, realtime processing events will be sent to the defined callback.","default":true},"receive_post_processing_events":{"type":"boolean","description":"If true, post-processing events will be sent to the defined callback.","default":true},"receive_acknowledgments":{"type":"boolean","description":"If true, acknowledgments will be sent to the defined callback.","default":false},"receive_errors":{"type":"boolean","description":"If true, errors will be sent to the defined callback.","default":false},"receive_lifecycle_events":{"type":"boolean","description":"If true, lifecycle events will be sent to the defined callback.","default":true}},"type":"object","description":"Specify the callback configuration"}},"title":"Gladia Real-time Transcription Settings","description":"Docs: https://docs.gladia.io/reference/live-audio"},"speechmatics_streaming":{"type":"object","properties":{"language":{"type":"string"},"domain":{"type":"string","description":"Request a specialized model based on 'language' but optimized for a particular field, e.g. \"finance\" or \"medical\"."},"output_locale":{"type":"string","minLength":1},"additional_vocab":{"type":"array","items":{"type":"object","oneOf":[{"type":"string","minLength":1},{"type":"object","properties":{"content":{"type":"string","minLength":1},"sounds_like":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["content"]}]}},"diarization":{"type":"string","enum":["none","speaker"]},"max_delay":{"type":"number","minimum":0},"max_delay_mode":{"type":"string","enum":["flexible","fixed"]},"speaker_diarization_config":{"type":"object","properties":{"max_speakers":{"type":"number","format":"integer","minimum":2,"maximum":100},"prefer_current_speaker":{"type":"boolean"},"speaker_sensitivity":{"type":"number","format":"float","minimum":0,"maximum":1}}},"audio_filtering_config":{"type":"object","properties":{"volume_threshold":{"type":"number","format":"float","minimum":0,"maximum":100}}},"transcript_filtering_config":{"type":"object","properties":{"remove_disfluencies":{"type":"boolean"},"replacements":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"]}}}},"enable_partials":{"type":"boolean","default":false},"enable_entities":{"type":"boolean","default":true},"operating_point":{"type":"string","enum":["standard","enhanced"]},"punctuation_overrides":{"type":"object","properties":{"permitted_marks":{"type":"array","description":"The punctuation marks which the client is prepared to accept in transcription output, or the special value 'all' (the default). Unsupported marks are ignored. This value is used to guide the transcription process.","items":{"pattern":"^(.|all)$","type":"string"}},"sensitivity":{"type":"number","description":"Ranges between zero and one. Higher values will produce more punctuation. The default is 0.5.","format":"float","maximum":1,"minimum":0}}},"conversation_config":{"type":"object","properties":{"end_of_utterance_silence_trigger":{"type":"number","format":"float","minimum":0,"maximum":2,"default":0}},"description":"This mode will detect when a speaker has stopped talking. The end_of_utterance_silence_trigger is the time in seconds after which the server will assume that the speaker has finished speaking, and will emit an EndOfUtterance message. A value of 0 disables the feature."}},"required":["language"],"title":"Speechmatics Real-time Transcription Settings","description":"You must specify `language` (e.g `en`)\n\nDocs: https://docs.speechmatics.com/rt-api-ref#transcription-config"},"elevenlabs_streaming":{"type":"object","properties":{"model_id":{"description":"The model to use for transcription.","type":"string","default":"eleven_whisper_v2_realtime"},"language_code":{"description":"ISO 639-1 two-letter language code. When not specified, the model auto-detects the language.","type":"string"},"previous_text":{"description":"Text from a previous transcription session to provide context for the model. Sent in the first message to the WebSocket.","type":"string"}},"title":"ElevenLabs Real-time Transcription Settings","description":"Docs: https://elevenlabs.io/docs/api-reference/speech-to-text"}}},"DesktopSdkUpload":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/NewDesktopSdkUploadStatus"}],"readOnly":true},"recording_id":{"type":"string","format":"uuid","nullable":true,"readOnly":true},"upload_token":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}}},"required":["created_at","id","recording_id","status","upload_token"]},"DesktopSdkUploadMinimal":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string","nullable":true}}},"required":["id","metadata"]},"DesktopSdkUploadMinimalRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string","nullable":true}}},"required":["metadata"]},"DesktopSdkUploadRequest":{"type":"object","properties":{"recording_config":{"allOf":[{"$ref":"#/components/schemas/DesktopSdkRecordingConfigRequest"}],"writeOnly":true,"nullable":true,"description":"Configure the recording generated by the SDK."},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"Format33bEnum":{"enum":["mp3","raw"],"type":"string","description":"* `mp3` - Mp3\n* `raw` - Raw"},"Format3b3Enum":{"enum":["mp4"],"type":"string","description":"* `mp4` - Mp4"},"GmeetMeetingInvite":{"type":"object","properties":{"meeting_id":{"type":"string"}},"required":["meeting_id"]},"GmeetMeetingInviteMeetingLink":{"type":"object","properties":{"platform":{"$ref":"#/components/schemas/GmeetMeetingInviteMeetingLinkPlatformEnum"},"meeting_id":{"type":"string"}},"required":["meeting_id","platform"]},"GmeetMeetingInviteMeetingLinkPlatformEnum":{"enum":["google_meet"],"type":"string","description":"* `google_meet` - google_meet"},"GoogleLogin":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"email":{"type":"string","format":"email","description":"The email address of the google account to use for login."},"is_active":{"type":"boolean","description":"If the login should be used for round robin. (default: true)"},"sso_v2_workspace_domain":{"type":"string","description":"The primary domain name of your Google Workspace Account used for SSO."},"sso_v2_private_key":{"type":"string","description":"PEM-formatted private key used for signing SSO requests."},"sso_v2_cert":{"type":"string","description":"PEM-formatted x509 certificate which is registered in your Google Workspace SSO Profile."},"group_id":{"type":"string","format":"uuid","description":"The id of the login group this login belongs to."},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true}},"required":["created_at","email","group_id","id","sso_v2_cert","sso_v2_private_key","sso_v2_workspace_domain","updated_at"]},"GoogleLoginGroup":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","description":"Name of the login group. It can used to filter out login groups when retrieving them via API.","maxLength":2000},"login_mode":{"allOf":[{"$ref":"#/components/schemas/LoginModeEnum"}],"description":"Login behaviour of bots that use this login group.\n\n* `always` - Always\n* `only_if_required` - Only If Required"},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true},"logins":{"type":"array","items":{"$ref":"#/components/schemas/GoogleLogin"},"readOnly":true}},"required":["created_at","id","login_mode","logins","name","updated_at"]},"GoogleLoginGroupRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Name of the login group. It can used to filter out login groups when retrieving them via API.","maxLength":2000},"login_mode":{"allOf":[{"$ref":"#/components/schemas/LoginModeEnum"}],"description":"Login behaviour of bots that use this login group.\n\n* `always` - Always\n* `only_if_required` - Only If Required"}},"required":["login_mode","name"]},"GoogleLoginRequest":{"type":"object","properties":{"email":{"type":"string","format":"email","minLength":1,"description":"The email address of the google account to use for login."},"is_active":{"type":"boolean","description":"If the login should be used for round robin. (default: true)"},"sso_v2_workspace_domain":{"type":"string","minLength":1,"description":"The primary domain name of your Google Workspace Account used for SSO."},"sso_v2_private_key":{"type":"string","minLength":1,"description":"PEM-formatted private key used for signing SSO requests."},"sso_v2_cert":{"type":"string","minLength":1,"description":"PEM-formatted x509 certificate which is registered in your Google Workspace SSO Profile."},"group_id":{"type":"string","format":"uuid","description":"The id of the login group this login belongs to."},"ios_oauth_refresh_token":{"type":"string","writeOnly":true,"nullable":true},"ios_oauth_access_token":{"type":"string","writeOnly":true,"nullable":true},"ios_oauth_access_token_expiry":{"type":"string","format":"date-time","writeOnly":true,"nullable":true},"ios_oauth_device_id":{"type":"string","writeOnly":true,"nullable":true,"maxLength":255}},"required":["email","group_id","sso_v2_cert","sso_v2_private_key","sso_v2_workspace_domain"]},"GoogleMeet":{"type":"object","properties":{"google_login_group_id":{"type":"string","format":"uuid","nullable":true,"description":"The ID of the google login group to use for this meeting."}}},"GoogleMeetEnum":{"enum":["web","web_4_core","web_gpu"],"type":"string","description":"* `web` - web\n* `web_4_core` - web_4_core\n* `web_gpu` - web_gpu"},"GoogleMeetRequest":{"type":"object","properties":{"google_login_group_id":{"type":"string","format":"uuid","nullable":true,"description":"The ID of the google login group to use for this meeting."}}},"GotoMeetingInvite":{"type":"object","properties":{"meeting_id":{"type":"string"}},"required":["meeting_id"]},"GotoMeetingInviteMeetingLink":{"type":"object","properties":{"platform":{"$ref":"#/components/schemas/GotoMeetingInviteMeetingLinkPlatformEnum"},"meeting_id":{"type":"string"}},"required":["meeting_id","platform"]},"GotoMeetingInviteMeetingLinkPlatformEnum":{"enum":["goto_meeting"],"type":"string","description":"* `goto_meeting` - goto_meeting"},"HuddleBotConfigSchema":{"type":"object","properties":{"bot_name":{"type":"string","default":"Meeting Notetaker","description":"The name of the bot that will be displayed in the call.\n*(Note: Authenticated Google Meet bots will use the Google account name and this field will be ignored.)*","maxLength":100},"recording_config":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfig"}],"nullable":true,"description":"Configure the recording generated by the bot. Includes options for getting meeting transcript,  the layout of the recorded video, when to start recording and more."},"output_media":{"allOf":[{"$ref":"#/components/schemas/OutputMedia"}],"nullable":true,"description":"Settings for the bot output media."},"automatic_video_output":{"allOf":[{"$ref":"#/components/schemas/AutomaticVideoOutput"}],"nullable":true,"description":"Settings for the bot to output video. Image should be 16:9. Read more about this here: https://docs.recall.ai/docs/output-video-in-meetings"},"automatic_audio_output":{"allOf":[{"$ref":"#/components/schemas/AutomaticAudioOutput"}],"nullable":true,"description":"Settings for the bot to output audio."},"chat":{"allOf":[{"$ref":"#/components/schemas/Chat"}],"nullable":true,"description":"Settings for the bot to send chat messages. \n*(Note: Chat functionality is only supported for Zoom, Google Meet and Microsoft Teams currently.)*"},"automatic_leave":{"allOf":[{"$ref":"#/components/schemas/AutomaticLeave"}],"nullable":true},"variant":{"allOf":[{"$ref":"#/components/schemas/BotVariant"}],"nullable":true,"description":"Configure bot variants per meeting platforms, e.g. {\"zoom\": \"web_4_core\"}."}}},"HuddleBotConfigSchemaRequest":{"type":"object","properties":{"bot_name":{"type":"string","minLength":1,"default":"Meeting Notetaker","description":"The name of the bot that will be displayed in the call.\n*(Note: Authenticated Google Meet bots will use the Google account name and this field will be ignored.)*","maxLength":100},"recording_config":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRequest"}],"nullable":true,"description":"Configure the recording generated by the bot. Includes options for getting meeting transcript,  the layout of the recorded video, when to start recording and more."},"output_media":{"allOf":[{"$ref":"#/components/schemas/OutputMediaRequest"}],"nullable":true,"description":"Settings for the bot output media."},"automatic_video_output":{"allOf":[{"$ref":"#/components/schemas/AutomaticVideoOutputRequest"}],"nullable":true,"description":"Settings for the bot to output video. Image should be 16:9. Read more about this here: https://docs.recall.ai/docs/output-video-in-meetings"},"automatic_audio_output":{"allOf":[{"$ref":"#/components/schemas/AutomaticAudioOutputRequest"}],"nullable":true,"description":"Settings for the bot to output audio."},"chat":{"allOf":[{"$ref":"#/components/schemas/ChatRequest"}],"nullable":true,"description":"Settings for the bot to send chat messages. \n*(Note: Chat functionality is only supported for Zoom, Google Meet and Microsoft Teams currently.)*"},"automatic_leave":{"allOf":[{"$ref":"#/components/schemas/AutomaticLeaveRequest"}],"nullable":true},"variant":{"allOf":[{"$ref":"#/components/schemas/BotVariantRequest"}],"nullable":true,"description":"Configure bot variants per meeting platforms, e.g. {\"zoom\": \"web_4_core\"}."}}},"LanguageCodeC40Enum":{"enum":["auto","bg","ca","cs","da","de","el","en","en_au","en_uk","en_us","es","et","fi","fr","he","hi","hr","hu","id","it","ja","ko","lt","lv","ms","nl","no","pl","pt","ro","ru","sk","sv","th","tr","uk","vi","zh"],"type":"string","description":"* `auto` - auto\n* `bg` - bg\n* `ca` - ca\n* `cs` - cs\n* `da` - da\n* `de` - de\n* `el` - el\n* `en` - en\n* `en_au` - en_au\n* `en_uk` - en_uk\n* `en_us` - en_us\n* `es` - es\n* `et` - et\n* `fi` - fi\n* `fr` - fr\n* `he` - he\n* `hi` - hi\n* `hr` - hr\n* `hu` - hu\n* `id` - id\n* `it` - it\n* `ja` - ja\n* `ko` - ko\n* `lt` - lt\n* `lv` - lv\n* `ms` - ms\n* `nl` - nl\n* `no` - no\n* `pl` - pl\n* `pt` - pt\n* `ro` - ro\n* `ru` - ru\n* `sk` - sk\n* `sv` - sv\n* `th` - th\n* `tr` - tr\n* `uk` - uk\n* `vi` - vi\n* `zh` - zh"},"LoginModeEnum":{"enum":["always","only_if_required"],"type":"string","description":"* `always` - Always\n* `only_if_required` - Only If Required"},"MeetMedia":{"type":"object","properties":{"space_name":{"type":"string"},"access_token":{"type":"string"}},"required":["access_token","space_name"]},"MeetMediaRequest":{"type":"object","properties":{"space_name":{"type":"string","minLength":1},"access_token":{"type":"string","minLength":1}},"required":["access_token","space_name"]},"MeetingAttendee":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"},"is_organizer":{"type":"boolean"},"status":{"$ref":"#/components/schemas/MeetingAttendeeStatusEnum"}},"required":["email","is_organizer","name","status"]},"MeetingAttendeeStatusEnum":{"enum":["accepted","declined","tentative","not_available"],"type":"string","description":"* `accepted` - accepted\n* `declined` - declined\n* `tentative` - tentative\n* `not_available` - not_available"},"MeetingCaptions":{"type":"object","properties":{"language_code":{"nullable":true,"title":"Language for captions. If not specified, the selection is meeting platform-specific.","allOf":[{"$ref":"#/components/schemas/MeetingCaptionsLanguageCodeEnum"}]}}},"MeetingCaptionsLanguageCodeEnum":{"enum":["cs","de","en","es","fil","fr","he","hi","it","ja","ko","nl","pl","pt","pt-BR","ro","ru","sv","th","tr","uk","vi","zh"],"type":"string","description":"* `cs` - Czech\n* `de` - German\n* `en` - English\n* `es` - Spanish\n* `fil` - Filipino\n* `fr` - French\n* `he` - Hebrew\n* `hi` - Hindi\n* `it` - Italian\n* `ja` - Japanese\n* `ko` - Korean\n* `nl` - Dutch\n* `pl` - Polish\n* `pt` - Portuguese\n* `pt-BR` - Portuguese (Brazil)\n* `ro` - Romanian\n* `ru` - Russian\n* `sv` - Swedish\n* `th` - Thai\n* `tr` - Turkish\n* `uk` - Ukrainian\n* `vi` - Vietnamese\n* `zh` - Chinese"},"MeetingCaptionsRequest":{"type":"object","properties":{"language_code":{"nullable":true,"title":"Language for captions. If not specified, the selection is meeting platform-specific.","allOf":[{"$ref":"#/components/schemas/MeetingCaptionsLanguageCodeEnum"}]}}},"MeetingDirectConnect":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/MeetingDirectConnectStatus"}],"readOnly":true},"zoom_rtms":{"allOf":[{"$ref":"#/components/schemas/ZoomRtms"}],"nullable":true},"google_meet_media_api":{"allOf":[{"$ref":"#/components/schemas/MeetMedia"}],"nullable":true},"recording_config":{"allOf":[{"$ref":"#/components/schemas/MeetingDirectConnectRecordingConfig"}],"nullable":true},"recordings":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingEmbed"},"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"The timestamp when the Meeting Direct Connect was created."}},"required":["created_at","id","recordings","status"]},"MeetingDirectConnectRecordingConfig":{"type":"object","properties":{"transcript":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigTranscriptArtifact"}],"nullable":true,"description":"Specify this to capture transcript of the meeting as part of the recording. Supports:\n- [Recall.ai Transcription](https://docs.recall.ai/docs/recallai-transcription)\n- [3rd-party AI transcription providers](https://docs.recall.ai/docs/ai-transcription)\n- [meeting caption transcription](https://docs.recall.ai/docs/meeting-caption-transcription)\n\n **[Read more about real-time transcription.](https://docs.recall.ai/docs/bot-real-time-transcription)**\n\nDefault: `null`\n\n"},"realtime_endpoints":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpoint"},"default":[],"description":"Add endpoints here to receive data (e.g transcript, participant events) from the recording in realtime during the meeting.\n\nDefault: `[]`\n\n"},"retention":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetention"}],"nullable":true,"description":"Specify the retention policy for the recording. **[Read more in this guide](https://docs.recall.ai/docs/storage-and-playback)**"},"video_mixed_layout":{"allOf":[{"$ref":"#/components/schemas/VideoMixedLayoutEnum"}],"default":"speaker_view","description":"The layout of the mixed video output.\n\n* `speaker_view` - speaker_view\n* `gallery_view` - gallery_view\n* `gallery_view_v2` - gallery_view_v2\n* `audio_only` - audio_only"},"video_mixed_mp4":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Capture mixed video of the meeting as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"participant_events":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"default":{},"description":"Capture participant events as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"meeting_metadata":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"default":{},"description":"Capture meeting metadata as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"video_mixed_participant_video_when_screenshare":{"allOf":[{"$ref":"#/components/schemas/VideoMixedParticipantVideoWhenScreenshareEnum"}],"default":"overlap","description":"The layout of participant video streams in mixed video output when screen is being shared. More docs: https://docs.recall.ai/docs/video-layouts\n\n* `hide` - hide\n* `beside` - beside\n* `overlap` - overlap"},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"audio_mixed_raw":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture mixed audio in raw format of the meeting.\n\nDefault: `null`\n\n"},"audio_mixed_mp3":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture mixed audio in the mp3 format of the meeting\n\nDefault: `null`\n\n"},"video_separate_mp4":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture separate video in mp4 format for each participant in the meeting. Only supported with video_mixed_layout='gallery_view_v2'. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-videos-per-participant-async)**\n\nDefault: `null`\n\n"},"audio_separate_raw":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture separate audio in raw format for each participant in the meeting(**limited support**).  **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-audio-per-participant-async)**\n\nDefault: `null`\n\n"},"audio_separate_mp3":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture separate audio in mp3 format for each participant in the meeting. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-audio-per-participant-async)**\n\nDefault: `null`\n\n"},"video_mixed_flv":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture mixed video in flv format(**required for rtmp streaming). \n\nDefault: `null`\n\n"},"video_separate_png":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture separate video in png format for each participant in the meeting. Only supported with video_mixed_layout='gallery_view_v2'. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-videos-per-participant-realtime)**\n\nDefault: `null`\n\n"},"video_separate_h264":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifact"}],"nullable":true,"description":"Specify this to capture separate video in compressed h264 for each participant in the meeting. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-videos-per-participant-realtime)**\n\nDefault: `null`\n\n"}}},"MeetingDirectConnectRecordingConfigRequest":{"type":"object","properties":{"transcript":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigTranscriptArtifactRequest"}],"nullable":true,"description":"Specify this to capture transcript of the meeting as part of the recording. Supports:\n- [Recall.ai Transcription](https://docs.recall.ai/docs/recallai-transcription)\n- [3rd-party AI transcription providers](https://docs.recall.ai/docs/ai-transcription)\n- [meeting caption transcription](https://docs.recall.ai/docs/meeting-caption-transcription)\n\n **[Read more about real-time transcription.](https://docs.recall.ai/docs/bot-real-time-transcription)**\n\nDefault: `null`\n\n"},"realtime_endpoints":{"type":"array","items":{"$ref":"#/components/schemas/BotRecordingConfigRealtimeEndpointRequest"},"default":[],"description":"Add endpoints here to receive data (e.g transcript, participant events) from the recording in realtime during the meeting.\n\nDefault: `[]`\n\n"},"retention":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRetentionRequest"}],"nullable":true,"description":"Specify the retention policy for the recording. **[Read more in this guide](https://docs.recall.ai/docs/storage-and-playback)**"},"video_mixed_layout":{"allOf":[{"$ref":"#/components/schemas/VideoMixedLayoutEnum"}],"default":"speaker_view","description":"The layout of the mixed video output.\n\n* `speaker_view` - speaker_view\n* `gallery_view` - gallery_view\n* `gallery_view_v2` - gallery_view_v2\n* `audio_only` - audio_only"},"video_mixed_mp4":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Capture mixed video of the meeting as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"participant_events":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"default":{},"description":"Capture participant events as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"meeting_metadata":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"default":{},"description":"Capture meeting metadata as part of the recording. **This is enabled by default**.\n\nDefault: `{}`\n\n"},"video_mixed_participant_video_when_screenshare":{"allOf":[{"$ref":"#/components/schemas/VideoMixedParticipantVideoWhenScreenshareEnum"}],"default":"overlap","description":"The layout of participant video streams in mixed video output when screen is being shared. More docs: https://docs.recall.ai/docs/video-layouts\n\n* `hide` - hide\n* `beside` - beside\n* `overlap` - overlap"},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"audio_mixed_raw":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture mixed audio in raw format of the meeting.\n\nDefault: `null`\n\n"},"audio_mixed_mp3":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture mixed audio in the mp3 format of the meeting\n\nDefault: `null`\n\n"},"video_separate_mp4":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture separate video in mp4 format for each participant in the meeting. Only supported with video_mixed_layout='gallery_view_v2'. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-videos-per-participant-async)**\n\nDefault: `null`\n\n"},"audio_separate_raw":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture separate audio in raw format for each participant in the meeting(**limited support**).  **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-audio-per-participant-async)**\n\nDefault: `null`\n\n"},"audio_separate_mp3":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture separate audio in mp3 format for each participant in the meeting. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-audio-per-participant-async)**\n\nDefault: `null`\n\n"},"video_mixed_flv":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture mixed video in flv format(**required for rtmp streaming). \n\nDefault: `null`\n\n"},"video_separate_png":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture separate video in png format for each participant in the meeting. Only supported with video_mixed_layout='gallery_view_v2'. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-videos-per-participant-realtime)**\n\nDefault: `null`\n\n"},"video_separate_h264":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigBaseArtifactRequest"}],"nullable":true,"description":"Specify this to capture separate video in compressed h264 for each participant in the meeting. **[Read more in this guide](https://docs.recall.ai/docs/how-to-get-separate-videos-per-participant-realtime)**\n\nDefault: `null`\n\n"}}},"MeetingDirectConnectRequest":{"type":"object","properties":{"zoom_rtms":{"allOf":[{"$ref":"#/components/schemas/ZoomRtmsRequest"}],"nullable":true},"google_meet_media_api":{"allOf":[{"$ref":"#/components/schemas/MeetMediaRequest"}],"nullable":true},"recording_config":{"allOf":[{"$ref":"#/components/schemas/MeetingDirectConnectRecordingConfigRequest"}],"nullable":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"MeetingDirectConnectStatus":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/MeetingDirectConnectStatusCodeEnum"},"sub_code":{"type":"string","nullable":true},"updated_at":{"type":"string","format":"date-time"}},"required":["code","sub_code","updated_at"]},"MeetingDirectConnectStatusCodeEnum":{"enum":["pending","connecting","processing","complete","failed"],"type":"string","description":"* `pending` - Pending\n* `connecting` - Connecting\n* `processing` - Processing\n* `complete` - Complete\n* `failed` - Failed"},"MeetingDirectConnectStatusRequest":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/MeetingDirectConnectStatusCodeEnum"},"sub_code":{"type":"string","nullable":true,"minLength":1},"updated_at":{"type":"string","format":"date-time"}},"required":["code","sub_code","updated_at"]},"MeetingInvite":{"oneOf":[{"$ref":"#/components/schemas/WebexMeetingInvite"},{"$ref":"#/components/schemas/GmeetMeetingInviteMeetingLink"},{"$ref":"#/components/schemas/GotoMeetingInviteMeetingLink"},{"$ref":"#/components/schemas/TeamsLiveMeetingInviteMeetingLink"},{"$ref":"#/components/schemas/TeamsMeetingInviteMeetingLink"},{"$ref":"#/components/schemas/ZoomMeetingInviteMeetingLink"}],"discriminator":{"propertyName":"platform","mapping":{"webex":"#/components/schemas/WebexMeetingInvite","google_meet":"#/components/schemas/GmeetMeetingInviteMeetingLink","goto_meeting":"#/components/schemas/GotoMeetingInviteMeetingLink","microsoft_teams_live":"#/components/schemas/TeamsLiveMeetingInviteMeetingLink","microsoft_teams":"#/components/schemas/TeamsMeetingInviteMeetingLink","zoom":"#/components/schemas/ZoomMeetingInviteMeetingLink"}}},"MeetingMetadataArtifact":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"recording":{"allOf":[{"$ref":"#/components/schemas/RecordingMinimal"}],"readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/ArtifactStatus"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"data":{"allOf":[{"$ref":"#/components/schemas/MeetingMetadataArtifactData"}],"readOnly":true}},"required":["created_at","data","id","metadata","recording","status"]},"MeetingMetadataArtifactData":{"type":"object","properties":{"title":{"type":"string","readOnly":true,"nullable":true},"zoom":{"allOf":[{"$ref":"#/components/schemas/MeetingMetadataArtifactDataZoom"}],"readOnly":true,"nullable":true}},"required":["title","zoom"]},"MeetingMetadataArtifactDataZoom":{"type":"object","properties":{"meeting_uuid":{"type":"string","nullable":true}},"required":["meeting_uuid"]},"MeetingMetadataArtifactDataZoomRequest":{"type":"object","properties":{"meeting_uuid":{"type":"string","nullable":true,"minLength":1}},"required":["meeting_uuid"]},"MeetingMetadataArtifactShortcut":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/ArtifactStatus"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"data":{"allOf":[{"$ref":"#/components/schemas/MeetingMetadataArtifactData"}],"readOnly":true}},"required":["created_at","data","id","metadata","status"]},"MeetingMetadataArtifactShortcutRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}},"required":["metadata"]},"MeetingPlatformEnum":{"enum":["zoom","google_meet","goto_meeting","microsoft_teams","microsoft_teams_live","webex","chime_sdk","webrtc","zoom_rtms","google_meet_media_api","slack_authenticator","slack_huddle_observer"],"type":"string","description":"* `zoom` - Zoom\n* `google_meet` - Meet\n* `goto_meeting` - Goto\n* `microsoft_teams` - Teams\n* `microsoft_teams_live` - Teams Live\n* `webex` - Webex\n* `chime_sdk` - Chime Sdk\n* `webrtc` - Webrtc\n* `zoom_rtms` - Zoom Rtms\n* `google_meet_media_api` - Google Meet Media Api\n* `slack_authenticator` - Slack Authenticator\n* `slack_huddle_observer` - Slack Huddle Observer"},"MeetingSyncStatusEnum":{"enum":["not_started","in_progress","completed","failed"],"type":"string","description":"* `not_started` - Not Started\n* `in_progress` - In Progress\n* `completed` - Completed\n* `failed` - Failed"},"MicrosoftTeamsEnum":{"enum":["web","web_4_core","web_gpu"],"type":"string","description":"* `web` - web\n* `web_4_core` - web_4_core\n* `web_gpu` - web_gpu"},"NewDesktopSdkUploadStatus":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/NewDesktopSdkUploadStatusCodeEnum"},"sub_code":{"type":"string","nullable":true},"updated_at":{"type":"string","format":"date-time"}},"required":["code","sub_code","updated_at"]},"NewDesktopSdkUploadStatusCodeEnum":{"enum":["pending","recording_started","recording_ended","uploading","complete","failed"],"type":"string","description":"* `pending` - Pending\n* `recording_started` - Recording Started\n* `recording_ended` - Recording Ended\n* `uploading` - Uploading\n* `complete` - Complete\n* `failed` - Failed"},"NewDesktopSdkUploadStatusRequest":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/NewDesktopSdkUploadStatusCodeEnum"},"sub_code":{"type":"string","nullable":true,"minLength":1},"updated_at":{"type":"string","format":"date-time"}},"required":["code","sub_code","updated_at"]},"OutputMedia":{"type":"object","properties":{"camera":{"$ref":"#/components/schemas/OutputMediaConfig"},"screenshare":{"$ref":"#/components/schemas/OutputMediaConfig"}}},"OutputMediaConfig":{"oneOf":[{"$ref":"#/components/schemas/OutputMediaWebpage"}],"discriminator":{"propertyName":"kind","mapping":{"webpage":"#/components/schemas/OutputMediaWebpage"}}},"OutputMediaConfigRequest":{"oneOf":[{"$ref":"#/components/schemas/OutputMediaWebpageRequest"}],"discriminator":{"propertyName":"kind","mapping":{"webpage":"#/components/schemas/OutputMediaWebpageRequest"}}},"OutputMediaRequest":{"type":"object","properties":{"camera":{"$ref":"#/components/schemas/OutputMediaConfigRequest"},"screenshare":{"$ref":"#/components/schemas/OutputMediaConfigRequest"}}},"OutputMediaWebpage":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/OutputMediaWebpageKindEnum"},"config":{"$ref":"#/components/schemas/OutputMediaWebpageConfig"}},"required":["config","kind"]},"OutputMediaWebpageConfig":{"type":"object","properties":{"url":{"type":"string","description":"URL for the webpage","format":"uri"}},"required":["url"]},"OutputMediaWebpageConfigRequest":{"type":"object","properties":{"url":{"type":"string","minLength":1,"description":"URL for the webpage","format":"uri"}},"required":["url"]},"OutputMediaWebpageKindEnum":{"enum":["webpage"],"type":"string","description":"* `webpage` - webpage"},"OutputMediaWebpageRequest":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/OutputMediaWebpageKindEnum"},"config":{"$ref":"#/components/schemas/OutputMediaWebpageConfigRequest"}},"required":["config","kind"]},"PaginatedAudioMixedArtifactList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/AudioMixedArtifact"}}}},"PaginatedAudioSeparateArtifactList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/AudioSeparateArtifact"}}}},"PaginatedBotList":{"type":"object","properties":{"count":{"type":"integer","example":123},"next":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=4"},"previous":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=2"},"results":{"type":"array","items":{"$ref":"#/components/schemas/Bot"}}}},"PaginatedCalendarEventList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/CalendarEvent"}}}},"PaginatedCalendarList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/Calendar"}}}},"PaginatedDesktopSdkUploadList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/DesktopSdkUpload"}}}},"PaginatedGoogleLoginGroupList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/GoogleLoginGroup"}}}},"PaginatedGoogleLoginList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/GoogleLogin"}}}},"PaginatedMeetingMetadataArtifactList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/MeetingMetadataArtifact"}}}},"PaginatedParticipantEventsArtifactList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/ParticipantEventsArtifact"}}}},"PaginatedRealtimeEndpointList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/RealtimeEndpoint"}}}},"PaginatedRecordingList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/Recording"}}}},"PaginatedTranscriptArtifactList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/TranscriptArtifact"}}}},"PaginatedVideoMixedArtifactList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/VideoMixedArtifact"}}}},"PaginatedVideoSeparateArtifactList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/VideoSeparateArtifact"}}}},"PaginatedZoomMeetingToCredentialList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/ZoomMeetingToCredential"}}}},"PaginatedZoomOAuthAppList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/ZoomOAuthApp"}}}},"PaginatedZoomOAuthAppLogList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/ZoomOAuthAppLog"}}}},"PaginatedZoomOAuthCredentialList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/ZoomOAuthCredential"}}}},"PaginatedZoomOAuthCredentialLogList":{"type":"object","properties":{"next":{"type":"string","nullable":true},"previous":{"type":"string","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/ZoomOAuthCredentialLog"}}}},"ParticipantEventsArtifact":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"recording":{"allOf":[{"$ref":"#/components/schemas/RecordingMinimal"}],"readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/ArtifactStatus"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"data":{"allOf":[{"$ref":"#/components/schemas/ParticipantEventsArtifactData"}],"readOnly":true}},"required":["created_at","data","id","metadata","recording","status"]},"ParticipantEventsArtifactData":{"type":"object","properties":{"participant_events_download_url":{"type":"string","format":"uri","readOnly":true,"nullable":true,"description":"Download all participant events for the recording. **[See response format here](https://docs.recall.ai/docs/download-schemas#json-participant-event-download-url)**"},"speaker_timeline_download_url":{"type":"string","format":"uri","readOnly":true,"nullable":true,"description":"Download speaker timeline for the recording. **[See response format here](https://docs.recall.ai/docs/download-schemas#json-speaker-timeline-download-url)**"},"participants_download_url":{"type":"string","format":"uri","readOnly":true,"nullable":true,"description":"Download all participants for the recording. **[See response format here](https://docs.recall.ai/docs/download-schemas#json-participant-download-url)**"}},"required":["participant_events_download_url","participants_download_url","speaker_timeline_download_url"]},"ParticipantEventsArtifactShortcut":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/ArtifactStatus"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"data":{"allOf":[{"$ref":"#/components/schemas/ParticipantEventsArtifactData"}],"readOnly":true}},"required":["created_at","data","id","metadata","status"]},"ParticipantEventsArtifactShortcutRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}},"required":["metadata"]},"PatchedAudioMixedArtifactRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"PatchedAudioSeparateArtifactRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"PatchedBotRequest":{"type":"object","properties":{"meeting_url":{"type":"string","description":"The url of the meeting. For example, https://zoom.us/j/123?pwd=456. This field will be cleared a few days after the bot has joined a call."},"bot_name":{"type":"string","minLength":1,"default":"Meeting Notetaker","description":"The name of the bot that will be displayed in the call.\n*(Note: Authenticated Google Meet bots will use the Google account name and this field will be ignored.)*","maxLength":100},"join_at":{"type":"string","format":"date-time","nullable":true,"description":"The time at which the bot will join the call, formatted in ISO 8601. This field can only be read from scheduled bots that have not yet joined a call."},"recording_config":{"allOf":[{"$ref":"#/components/schemas/BotRecordingConfigRequest"}],"nullable":true,"description":"Configure the recording generated by the bot. Includes options for getting meeting transcript,  the layout of the recorded video, when to start recording and more."},"output_media":{"allOf":[{"$ref":"#/components/schemas/OutputMediaRequest"}],"nullable":true,"description":"Settings for the bot output media."},"automatic_video_output":{"allOf":[{"$ref":"#/components/schemas/AutomaticVideoOutputRequest"}],"nullable":true,"description":"Settings for the bot to output video. Image should be 16:9. Read more about this here: https://docs.recall.ai/docs/output-video-in-meetings"},"automatic_audio_output":{"allOf":[{"$ref":"#/components/schemas/AutomaticAudioOutputRequest"}],"nullable":true,"description":"Settings for the bot to output audio."},"chat":{"allOf":[{"$ref":"#/components/schemas/ChatRequest"}],"nullable":true,"description":"Settings for the bot to send chat messages. \n*(Note: Chat functionality is only supported for Zoom, Google Meet and Microsoft Teams currently.)*"},"automatic_leave":{"allOf":[{"$ref":"#/components/schemas/AutomaticLeaveRequest"}],"nullable":true},"variant":{"allOf":[{"$ref":"#/components/schemas/BotVariantRequest"}],"nullable":true,"description":"Configure bot variants per meeting platforms, e.g. {\"zoom\": \"web_4_core\"}."},"zoom":{"allOf":[{"$ref":"#/components/schemas/ZoomRequest"}],"nullable":true,"description":"Zoom specific parameters"},"google_meet":{"allOf":[{"$ref":"#/components/schemas/GoogleMeetRequest"}],"nullable":true,"description":"Google Meet specific parameters"},"webex":{"allOf":[{"$ref":"#/components/schemas/WebexRequest"}],"nullable":true,"description":"Webex specific parameters"},"breakout_room":{"allOf":[{"$ref":"#/components/schemas/_BreakoutRoomSchemaRequest"}],"nullable":true,"description":"Configure how the bot handles breakout rooms. Currently, Zoom is supported.Examples: {\"mode\": \"join_main_room\"} | {\"mode\": \"join_specific_room\", \"room_id\": \"<uuid>\"} | {\"mode\": \"auto_accept_all_invites\"} (default)."},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"PatchedCalendarRecordingPreferencesRequest":{"type":"object","properties":{"record_non_host":{"type":"boolean"},"record_recurring":{"type":"boolean"},"record_external":{"type":"boolean"},"record_internal":{"type":"boolean"},"record_confirmed":{"type":"boolean"},"record_only_host":{"type":"boolean"},"bot_name":{"type":"string","minLength":1}}},"PatchedCalendarRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}},"oauth_client_id":{"type":"string","minLength":1,"maxLength":2000},"oauth_client_secret":{"type":"string","minLength":1,"maxLength":2000},"oauth_refresh_token":{"type":"string","minLength":1,"maxLength":10000},"platform":{"$ref":"#/components/schemas/CalendarPlatformEnum"},"webhook_url":{"type":"string","format":"uri","minLength":1,"maxLength":2000,"deprecated":true},"oauth_email":{"type":"string","format":"email","minLength":1,"maxLength":2000}}},"PatchedGoogleLoginGroupRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Name of the login group. It can used to filter out login groups when retrieving them via API.","maxLength":2000},"login_mode":{"allOf":[{"$ref":"#/components/schemas/LoginModeEnum"}],"description":"Login behaviour of bots that use this login group.\n\n* `always` - Always\n* `only_if_required` - Only If Required"}}},"PatchedGoogleLoginRequest":{"type":"object","properties":{"email":{"type":"string","format":"email","minLength":1,"description":"The email address of the google account to use for login."},"is_active":{"type":"boolean","description":"If the login should be used for round robin. (default: true)"},"sso_v2_workspace_domain":{"type":"string","minLength":1,"description":"The primary domain name of your Google Workspace Account used for SSO."},"sso_v2_private_key":{"type":"string","minLength":1,"description":"PEM-formatted private key used for signing SSO requests."},"sso_v2_cert":{"type":"string","minLength":1,"description":"PEM-formatted x509 certificate which is registered in your Google Workspace SSO Profile."},"group_id":{"type":"string","format":"uuid","description":"The id of the login group this login belongs to."},"ios_oauth_refresh_token":{"type":"string","writeOnly":true,"nullable":true},"ios_oauth_access_token":{"type":"string","writeOnly":true,"nullable":true},"ios_oauth_access_token_expiry":{"type":"string","format":"date-time","writeOnly":true,"nullable":true},"ios_oauth_device_id":{"type":"string","writeOnly":true,"nullable":true,"maxLength":255}}},"PatchedMeetingMetadataArtifactRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"PatchedParticipantEventsArtifactRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"PatchedRealtimeEndpointRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"PatchedRecordingRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"PatchedSlackTeamIntegrationRequest":{"type":"object","properties":{"email_address":{"type":"string","format":"email","minLength":1,"description":"The email address of the bot user. This is the email address that the customer will invite to their Slack workspace."},"slack_team_domain":{"type":"string","minLength":1,"description":"The domain of the Slack workspace that the bot user will be invited to. For instance \"mycompany.slack.com\".","pattern":"^[a-zA-Z0-9-]+\\.slack\\.com$"},"bot_name":{"type":"string","minLength":1,"description":"The name of the bot user. This is the name that will be displayed in Slack."},"profile_photo_base64_jpg":{"type":"string","nullable":true,"minLength":1,"description":"The profile photo of the bot user, encoded as a base64 string. This is the profile photo that will be displayed in Slack. This must be a 512x512px JPEG image.","maxLength":1835008},"auto_join_public_huddles":{"type":"boolean","description":"Whether the bot user should automatically join huddles occuring in public channels."},"ask_to_join_private_huddles":{"type":"boolean","description":"Whether the bot user should ask to join huddles occuring in private channels."},"ask_to_join_message":{"type":"string","minLength":1,"description":"The message that the bot user will send when asking to join a private huddle."},"filter_huddles_by_user_emails":{"type":"array","items":{"type":"string","format":"email","minLength":1},"nullable":true,"description":"A list of email addresses. If this is set, the bot user will only join huddles where one of the users is a participant of the huddle."},"huddle_bot_config":{"allOf":[{"$ref":"#/components/schemas/HuddleBotConfigSchemaRequest"}],"description":"The configuration of the bot to join a huddle."}}},"PatchedTranscriptArtifactRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"PatchedVideoMixedArtifactRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"PatchedVideoSeparateArtifactRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"PatchedZoomOAuthAppPartialUpdateRequest":{"type":"object","properties":{"webhook_secret":{"type":"string","minLength":1},"client_secret":{"type":"string","minLength":1}}},"PinParticipantRequest":{"type":"object","properties":{"id":{"type":"integer","description":"The ID of the participant to pin. If not specified, the bot will unpin any currently pinned participant."}}},"RealtimeEndpoint":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"recording":{"allOf":[{"$ref":"#/components/schemas/RecordingMinimal"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"type":{"type":"string","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/RealtimeEndpointStatus"}],"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"events":{"type":"array","items":{"type":"string"},"readOnly":true}},"required":["created_at","events","id","metadata","recording","status","type","url"]},"RealtimeEndpointMinimal":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string","nullable":true}}},"required":["id","metadata"]},"RealtimeEndpointMinimalRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string","nullable":true}}},"required":["metadata"]},"RealtimeEndpointStatus":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/RealtimeEndpointStatusCodeEnum"},"sub_code":{"type":"string","nullable":true},"updated_at":{"type":"string","format":"date-time"}},"required":["code","sub_code","updated_at"]},"RealtimeEndpointStatusCodeEnum":{"enum":["running","done","failed","deleted"],"type":"string","description":"* `running` - Running\n* `done` - Done\n* `failed` - Failed\n* `deleted` - Deleted"},"RealtimeEndpointStatusRequest":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/RealtimeEndpointStatusCodeEnum"},"sub_code":{"type":"string","nullable":true,"minLength":1},"updated_at":{"type":"string","format":"date-time"}},"required":["code","sub_code","updated_at"]},"RecallaiAsyncTranscriptionRequest":{"type":"object","properties":{"language_code":{"allOf":[{"$ref":"#/components/schemas/LanguageCodeC40Enum"}],"default":"auto","description":"Must be `en` in low latency mode. Docs: https://docs.recall.ai/docs/recallai-transcription\n\n* `auto` - auto\n* `bg` - bg\n* `ca` - ca\n* `cs` - cs\n* `da` - da\n* `de` - de\n* `el` - el\n* `en` - en\n* `en_au` - en_au\n* `en_uk` - en_uk\n* `en_us` - en_us\n* `es` - es\n* `et` - et\n* `fi` - fi\n* `fr` - fr\n* `he` - he\n* `hi` - hi\n* `hr` - hr\n* `hu` - hu\n* `id` - id\n* `it` - it\n* `ja` - ja\n* `ko` - ko\n* `lt` - lt\n* `lv` - lv\n* `ms` - ms\n* `nl` - nl\n* `no` - no\n* `pl` - pl\n* `pt` - pt\n* `ro` - ro\n* `ru` - ru\n* `sk` - sk\n* `sv` - sv\n* `th` - th\n* `tr` - tr\n* `uk` - uk\n* `vi` - vi\n* `zh` - zh"},"spelling":{"type":"array","items":{"$ref":"#/components/schemas/RecallaiSpellingEntryRequest"},"description":"List of text strings to find/replace in the transcript."},"key_terms":{"type":"array","items":{"type":"string","minLength":1},"description":"Increases the chances that these terms appear in the transcript over some sound-alikes."},"filter_profanity":{"type":"boolean","default":false}}},"RecallaiSpellingEntry":{"type":"object","properties":{"find":{"type":"array","items":{"type":"string"},"description":"Find any of these items in the source transcript"},"replace":{"type":"string","description":"Replace found matches with this exact string (will not change case)"}},"required":["find","replace"]},"RecallaiSpellingEntryRequest":{"type":"object","properties":{"find":{"type":"array","items":{"type":"string","minLength":1},"description":"Find any of these items in the source transcript"},"replace":{"type":"string","minLength":1,"description":"Replace found matches with this exact string (will not change case)"}},"required":["find","replace"]},"RecallaiStreamingTranscription":{"type":"object","properties":{"language_code":{"allOf":[{"$ref":"#/components/schemas/LanguageCodeC40Enum"}],"default":"auto","description":"Must be `en` in low latency mode. Docs: https://docs.recall.ai/docs/recallai-transcription\n\n* `auto` - auto\n* `bg` - bg\n* `ca` - ca\n* `cs` - cs\n* `da` - da\n* `de` - de\n* `el` - el\n* `en` - en\n* `en_au` - en_au\n* `en_uk` - en_uk\n* `en_us` - en_us\n* `es` - es\n* `et` - et\n* `fi` - fi\n* `fr` - fr\n* `he` - he\n* `hi` - hi\n* `hr` - hr\n* `hu` - hu\n* `id` - id\n* `it` - it\n* `ja` - ja\n* `ko` - ko\n* `lt` - lt\n* `lv` - lv\n* `ms` - ms\n* `nl` - nl\n* `no` - no\n* `pl` - pl\n* `pt` - pt\n* `ro` - ro\n* `ru` - ru\n* `sk` - sk\n* `sv` - sv\n* `th` - th\n* `tr` - tr\n* `uk` - uk\n* `vi` - vi\n* `zh` - zh"},"spelling":{"type":"array","items":{"$ref":"#/components/schemas/RecallaiSpellingEntry"},"description":"List of text strings to find/replace in the transcript."},"key_terms":{"type":"array","items":{"type":"string"},"description":"Increases the chances that these terms appear in the transcript over some sound-alikes."},"filter_profanity":{"type":"boolean","default":false},"mode":{"allOf":[{"$ref":"#/components/schemas/RecallaiStreamingTranscriptionModeEnum"}],"default":"prioritize_accuracy","description":"The mode of the transcription algorithm. If you just want the transcript very quickly after the call is over, use `prioritize_accuracy`. If you need the words on realtime endpoints within seconds of utterance, use `prioritize_low_latency`, with the caveat that most features are unsupported in low latency mode.\n\n* `prioritize_low_latency` - prioritize_low_latency\n* `prioritize_accuracy` - prioritize_accuracy"}}},"RecallaiStreamingTranscriptionModeEnum":{"enum":["prioritize_low_latency","prioritize_accuracy"],"type":"string","description":"* `prioritize_low_latency` - prioritize_low_latency\n* `prioritize_accuracy` - prioritize_accuracy"},"RecallaiStreamingTranscriptionRequest":{"type":"object","properties":{"language_code":{"allOf":[{"$ref":"#/components/schemas/LanguageCodeC40Enum"}],"default":"auto","description":"Must be `en` in low latency mode. Docs: https://docs.recall.ai/docs/recallai-transcription\n\n* `auto` - auto\n* `bg` - bg\n* `ca` - ca\n* `cs` - cs\n* `da` - da\n* `de` - de\n* `el` - el\n* `en` - en\n* `en_au` - en_au\n* `en_uk` - en_uk\n* `en_us` - en_us\n* `es` - es\n* `et` - et\n* `fi` - fi\n* `fr` - fr\n* `he` - he\n* `hi` - hi\n* `hr` - hr\n* `hu` - hu\n* `id` - id\n* `it` - it\n* `ja` - ja\n* `ko` - ko\n* `lt` - lt\n* `lv` - lv\n* `ms` - ms\n* `nl` - nl\n* `no` - no\n* `pl` - pl\n* `pt` - pt\n* `ro` - ro\n* `ru` - ru\n* `sk` - sk\n* `sv` - sv\n* `th` - th\n* `tr` - tr\n* `uk` - uk\n* `vi` - vi\n* `zh` - zh"},"spelling":{"type":"array","items":{"$ref":"#/components/schemas/RecallaiSpellingEntryRequest"},"description":"List of text strings to find/replace in the transcript."},"key_terms":{"type":"array","items":{"type":"string","minLength":1},"description":"Increases the chances that these terms appear in the transcript over some sound-alikes."},"filter_profanity":{"type":"boolean","default":false},"mode":{"allOf":[{"$ref":"#/components/schemas/RecallaiStreamingTranscriptionModeEnum"}],"default":"prioritize_accuracy","description":"The mode of the transcription algorithm. If you just want the transcript very quickly after the call is over, use `prioritize_accuracy`. If you need the words on realtime endpoints within seconds of utterance, use `prioritize_low_latency`, with the caveat that most features are unsupported in low latency mode.\n\n* `prioritize_low_latency` - prioritize_low_latency\n* `prioritize_accuracy` - prioritize_accuracy"}}},"Recording":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"started_at":{"type":"string","format":"date-time","readOnly":true,"nullable":true},"completed_at":{"type":"string","format":"date-time","readOnly":true,"nullable":true},"status":{"allOf":[{"$ref":"#/components/schemas/RecordingStatus"}],"readOnly":true},"media_shortcuts":{"allOf":[{"$ref":"#/components/schemas/RecordingShortcuts"}],"readOnly":true},"realtime_endpoints":{"type":"array","items":{"$ref":"#/components/schemas/RealtimeEndpointMinimal"},"readOnly":true},"bot":{"allOf":[{"$ref":"#/components/schemas/BotMinimal"}],"readOnly":true,"nullable":true},"desktop_sdk_upload":{"allOf":[{"$ref":"#/components/schemas/DesktopSdkUploadMinimal"}],"readOnly":true,"nullable":true},"expires_at":{"type":"string","format":"date-time","readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}}},"required":["bot","completed_at","created_at","desktop_sdk_upload","expires_at","id","media_shortcuts","metadata","realtime_endpoints","started_at","status"]},"RecordingCreateTranscriptArtifactProviderRequest":{"type":"object","properties":{"assembly_ai_async":{"properties":{"audio_end_at":{"x-label":"Audio end at","description":"The point in time, in milliseconds, to stop transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer"},"audio_start_from":{"x-label":"Audio start from","description":"The point in time, in milliseconds, to begin transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer"},"auto_chapters":{"x-label":"Auto chapters","description":"Enable [Auto Chapters](https://www.assemblyai.com/docs/speech-understanding/auto-chapters), can be true or false","type":"boolean","default":false},"auto_highlights":{"x-label":"Key phrases","description":"Enable [Key Phrases](https://www.assemblyai.com/docs/speech-understanding/key-phrases), either true or false","type":"boolean","default":false},"content_safety":{"x-label":"Content Moderation","description":"Enable [Content Moderation](https://www.assemblyai.com/docs/content-moderation), can be true or false","type":"boolean","default":false},"content_safety_confidence":{"x-label":"Content Moderation confidence","description":"The confidence threshold for the [Content Moderation](https://www.assemblyai.com/docs/content-moderation) model. Values must be between 25 and 100.","type":"integer","default":50,"minimum":25,"maximum":100},"custom_spelling":{"x-label":"Custom spellings","description":"Customize how words are spelled and formatted using to and from values. See [Custom Spelling](https://www.assemblyai.com/docs/pre-recorded-audio/custom-spelling) for more details.","type":"array","items":{"x-label":"Custom spelling","description":"Object containing words or phrases to replace, and the word or phrase to replace with","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"from":{"x-label":"From","description":"Words or phrases to replace","type":"array","items":{"x-label":"Word or phrase","description":"Word or phrase to replace","type":"string"}},"to":{"x-label":"To","description":"Word to replace with","type":"string"}},"required":["from","to"],"example":{"from":["dicarlo"],"to":"Decarlo"}}},"disfluencies":{"x-label":"Disfluencies","description":"Transcribe [Filler Words](https://www.assemblyai.com/docs/pre-recorded-audio/filler-words), like \"umm\", in your media file; can be true or false","type":"boolean","default":false},"entity_detection":{"x-label":"Entity Detection","description":"Enable [Entity Detection](https://www.assemblyai.com/docs/speech-understanding/entity-detection), can be true or false","type":"boolean","default":false},"filter_profanity":{"x-label":"Filter profanity","description":"Filter profanity from the transcribed text, can be true or false. See [Profanity Filtering](https://www.assemblyai.com/docs/profanity-filtering) for more details.","type":"boolean","default":false},"format_text":{"x-label":"Format text","description":"Enable [Text Formatting](https://www.assemblyai.com/docs/pre-recorded-audio), can be true or false","type":"boolean","default":true},"iab_categories":{"x-label":"Topic Detection","description":"Enable [Topic Detection](https://www.assemblyai.com/docs/speech-understanding/topic-detection), can be true or false","type":"boolean","default":false},"keyterms_prompt":{"x-label":"Keyterms prompt","description":"Improve accuracy with up to 200 (for Universal-2) or 1000 (for Universal-3-Pro) domain-specific words or phrases (maximum 6 words per phrase). See [Keyterms Prompting](https://www.assemblyai.com/docs/pre-recorded-audio/keyterms-prompting) for more details.\n","type":"array","items":{"x-label":"Keyterm","type":"string"}},"language_code":{"x-label":"Language code","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","oneOf":[{"anyOf":[{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"}}},{"type":"string"}]},{"type":"string","nullable":true}],"default":"en_us","x-ts-type":"LiteralUnion<TranscriptLanguageCode, string> | null","x-go-type":"TranscriptLanguageCode"},"language_codes":{"description":"The language codes of your audio file. Used for [Code switching](/docs/speech-to-text/pre-recorded-audio/code-switching)\nOne of the values specified must be `en`.\n","type":"array","items":{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"}}},"nullable":true},"language_confidence_threshold":{"x-label":"Language confidence threshold","description":"The confidence threshold for the automatically detected language.\nAn error will be returned if the language confidence is below this threshold.\nDefaults to 0. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0},"language_detection":{"x-label":"Language detection","description":"Enable [Automatic language detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection), either true or false.","type":"boolean","default":false},"language_detection_options":{"x-label":"Specify options for Automatic Language Detection.","description":"Specify options for [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection).","type":"object","additionalProperties":false,"properties":{"expected_languages":{"x-label":"Expected languages","description":"List of languages expected in the audio file. Defaults to `[\"all\"]` when unspecified. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.","type":"array","items":{"x-label":"language","type":"string"}},"fallback_language":{"x-label":"Fallback language","description":"If the detected language of the audio file is not in the list of expected languages, the `fallback_language` is used. Specify `[\"auto\"]` to let our model choose the fallback language from `expected_languages` with the highest confidence score. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"string","default":"auto"},"code_switching":{"x-label":"Code switching","description":"Whether [code switching](/docs/speech-to-text/pre-recorded-audio/code-switching) should be detected.\n","type":"boolean","default":false},"code_switching_confidence_threshold":{"x-label":"Code switching confidence threshold","description":"The confidence threshold for [code switching](/docs/speech-to-text/pre-recorded-audio/code-switching) detection. If the code switching confidence is below this threshold, the transcript will be processed in the language with the highest `language_detection_confidence` score.\n","type":"number","minimum":0,"maximum":1,"default":0.3}}},"multichannel":{"x-label":"Multichannel","description":"Enable [Multichannel](https://www.assemblyai.com/docs/pre-recorded-audio/multichannel) transcription, can be true or false.","type":"boolean","default":false},"prompt":{"x-label":"Prompt","description":"Provide natural language prompting of up to 1,500 words of contextual information to the model. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for best practices.\n\nNote: This parameter is only supported for the Universal-3-Pro model.\n","type":"string"},"punctuate":{"x-label":"Punctuate","description":"Enable [Automatic Punctuation](https://www.assemblyai.com/docs/pre-recorded-audio), can be true or false","type":"boolean","default":true},"redact_pii":{"x-label":"Redact PII","description":"Redact PII from the transcribed text using the Redact PII model, can be true or false. See [PII Redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"boolean","default":false},"redact_pii_audio":{"x-label":"Redact PII audio","description":"Generate a copy of the original media file with spoken PII \"beeped\" out, can be true or false. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","type":"boolean","default":false},"redact_pii_audio_options":{"x-label":"Specify options for PII redacted audio files.","description":"Specify options for [PII redacted audio](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) files.","type":"object","additionalProperties":false,"properties":{"return_redacted_no_speech_audio":{"x-label":"Return redacted no speech audio","description":"By default, audio redaction provides redacted audio URLs only when speech is detected. However, if your use-case specifically requires redacted audio files even for silent audio files without any dialogue, you can opt to receive these URLs by setting this parameter to `true`.","type":"boolean","default":false}}},"redact_pii_audio_quality":{"x-label":"Redact PII audio quality","type":"string","description":"Controls the filetype of the audio created by redact_pii_audio. Currently supports mp3 (default) and wav. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","x-fern-sdk-group-name":"transcripts","enum":["mp3","wav"],"x-fern-enum":{"mp3":{"description":"MP3 audio format is lower quality and lower size than WAV.","casing":{"camel":"mp3","snake":"mp3","pascal":"Mp3","screamingSnake":"MP3"}},"wav":{"description":"WAV audio format is the highest quality (no compression) and larger size than MP3."}},"x-aai-enum":{"mp3":{"label":"MP3"},"wav":{"label":"WAV"}},"example":"mp3"},"redact_pii_policies":{"x-label":"Redact PII policies","description":"The list of PII Redaction policies to enable. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"array","items":{"x-label":"PII policy","description":"The type of PII to redact","x-fern-sdk-group-name":"transcripts","type":"string","enum":["account_number","banking_information","blood_type","credit_card_cvv","credit_card_expiration","credit_card_number","date","date_interval","date_of_birth","drivers_license","drug","duration","email_address","event","filename","gender_sexuality","healthcare_number","injury","ip_address","language","location","marital_status","medical_condition","medical_process","money_amount","nationality","number_sequence","occupation","organization","passport_number","password","person_age","person_name","phone_number","physical_attribute","political_affiliation","religion","statistics","time","url","us_social_security_number","username","vehicle_id","zodiac_sign"],"x-fern-enum":{"account_number":{"description":"Customer account or membership identification number (e.g., Policy No. 10042992, Member ID: HZ-5235-001)"},"banking_information":{"description":"Banking information, including account and routing numbers"},"blood_type":{"description":"Blood type (e.g., O-, AB positive)"},"credit_card_cvv":{"description":"Credit card verification code (e.g., CVV: 080)"},"credit_card_expiration":{"description":"Expiration date of a credit card"},"credit_card_number":{"description":"Credit card number"},"date":{"description":"Specific calendar date (e.g., December 18)"},"date_interval":{"description":"Broader time periods, including date ranges, months, seasons, years, and decades (e.g., 2020-2021, 5-9 May, January 1984)"},"date_of_birth":{"description":"Date of birth (e.g., Date of Birth: March 7,1961)"},"drivers_license":{"description":"Driver's license number. (e.g., DL# 356933-540)"},"drug":{"description":"Medications, vitamins, or supplements (e.g., Advil, Acetaminophen, Panadol)"},"duration":{"description":"Periods of time, specified as a number and a unit of time (e.g., 8 months, 2 years)"},"email_address":{"description":"Email address (e.g., support@assemblyai.com)"},"event":{"description":"Name of an event or holiday (e.g., Olympics, Yom Kippur)"},"filename":{"description":"Names of computer files, including the extension or filepath (e.g., Taxes/2012/brad-tax-returns.pdf)"},"gender_sexuality":{"description":"Terms indicating gender identity or sexual orientation, including slang terms (e.g., female, bisexual, trans)"},"healthcare_number":{"description":"Healthcare numbers and health plan beneficiary numbers (e.g., Policy No.: 5584-486-674-YM)"},"injury":{"description":"Bodily injury (e.g., I broke my arm, I have a sprained wrist)"},"ip_address":{"description":"Internet IP address, including IPv4 and IPv6 formats (e.g., 192.168.0.1)"},"language":{"description":"Name of a natural language (e.g., Spanish, French)"},"location":{"description":"Any Location reference including mailing address, postal code, city, state, province, country, or coordinates. (e.g., Lake Victoria, 145 Windsor St., 90210)"},"marital_status":{"description":"Terms indicating marital status (e.g., Single, common-law, ex-wife, married)"},"medical_condition":{"description":"Name of a medical condition, disease, syndrome, deficit, or disorder (e.g., chronic fatigue syndrome, arrhythmia, depression)"},"medical_process":{"description":"Medical process, including treatments, procedures, and tests (e.g., heart surgery, CT scan)"},"money_amount":{"description":"Name and/or amount of currency (e.g., 15 pesos, $94.50)"},"nationality":{"description":"Terms indicating nationality, ethnicity, or race (e.g., American, Asian, Caucasian)"},"number_sequence":{"description":"Numerical PII (including alphanumeric strings) that doesn't fall under other categories"},"occupation":{"description":"Job title or profession (e.g., professor, actors, engineer, CPA)"},"organization":{"description":"Name of an organization (e.g., CNN, McDonalds, University of Alaska, Northwest General Hospital)"},"passport_number":{"description":"Passport numbers, issued by any country (e.g., PA4568332, NU3C6L86S12)"},"password":{"description":"Account passwords, PINs, access keys, or verification answers (e.g., 27%alfalfa, temp1234, My mother's maiden name is Smith)"},"person_age":{"description":"Number associated with an age (e.g., 27, 75)"},"person_name":{"description":"Name of a person (e.g., Bob, Doug Jones, Dr. Kay Martinez, MD)"},"phone_number":{"description":"Telephone or fax number"},"physical_attribute":{"description":"Distinctive bodily attributes, including terms indicating race (e.g., I'm 190cm tall, He belongs to the Black students' association)"},"political_affiliation":{"description":"Terms referring to a political party, movement, or ideology (e.g., Republican, Liberal)"},"religion":{"description":"Terms indicating religious affiliation (e.g., Hindu, Catholic)"},"statistics":{"description":"Medical statistics (e.g., 18%, 18 percent)"},"time":{"description":"Expressions indicating clock times (e.g., 19:37:28, 10pm EST)"},"url":{"description":"Internet addresses (e.g., https://www.assemblyai.com/)"},"us_social_security_number":{"description":"Social Security Number or equivalent"},"username":{"description":"Usernames, login names, or handles (e.g., @AssemblyAI)"},"vehicle_id":{"description":"Vehicle identification numbers (VINs), vehicle serial numbers, and license plate numbers (e.g., 5FNRL38918B111818, BIF7547)"},"zodiac_sign":{"description":"Names of Zodiac signs (e.g., Aries, Taurus)"}},"x-aai-enum":{"account_number":{"label":"Account number"},"banking_information":{"label":"Banking information"},"blood_type":{"label":"Blood type"},"credit_card_cvv":{"label":"Credit card CVV"},"credit_card_expiration":{"label":"Credit card expiration"},"credit_card_number":{"label":"Credit card number"},"date":{"label":"Date"},"date_interval":{"label":"Date interval"},"date_of_birth":{"label":"Date of birth"},"drivers_license":{"label":"Driver's license"},"drug":{"label":"Drug"},"duration":{"label":"Duration"},"email_address":{"label":"Email address"},"event":{"label":"Event"},"filename":{"label":"Filename"},"gender_sexuality":{"label":"Gender sexuality"},"healthcare_number":{"label":"Healthcare number"},"injury":{"label":"Injury"},"ip_address":{"label":"IP address"},"language":{"label":"Language"},"location":{"label":"Location"},"marital_status":{"label":"Marital status"},"medical_condition":{"label":"Medical condition"},"medical_process":{"label":"Medical process"},"money_amount":{"label":"Money amount"},"nationality":{"label":"Nationality"},"number_sequence":{"label":"Number sequence"},"occupation":{"label":"Occupation"},"organization":{"label":"Organization"},"passport_number":{"label":"Passport number"},"password":{"label":"Password"},"person_age":{"label":"Person age"},"person_name":{"label":"Person name"},"phone_number":{"label":"Phone number"},"physical_attribute":{"label":"Physical attribute"},"political_affiliation":{"label":"Political affiliation"},"religion":{"label":"Religion"},"statistics":{"label":"Statistics"},"time":{"label":"Time"},"url":{"label":"URL"},"us_social_security_number":{"label":"US Social Security Number"},"username":{"label":"Username"},"vehicle_id":{"label":"Vehicle ID"},"zodiac_sign":{"label":"Zodiac sign"}}}},"redact_pii_sub":{"x-label":"Redact PII substitution","description":"The replacement logic for detected PII, can be `entity_type` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","oneOf":[{"x-label":"Redact PII substitution","type":"string","x-fern-sdk-group-name":"transcripts","description":"The replacement logic for detected PII, can be `entity_name` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","enum":["entity_name","hash"],"x-aai-enum":{"entity_name":{"label":"Entity name"},"hash":{"label":"Hash"}}},{"type":"string","nullable":true}],"default":"hash"},"sentiment_analysis":{"x-label":"Sentiment Analysis","description":"Enable [Sentiment Analysis](https://www.assemblyai.com/docs/speech-understanding/sentiment-analysis), can be true or false","type":"boolean","default":false},"speaker_labels":{"x-label":"Speaker labels","description":"Enable [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization), can be true or false","type":"boolean","default":false},"speaker_options":{"x-label":"Specify options for speaker diarization.","description":"Specify options for [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers). Use this to set a range of possible speakers.","type":"object","additionalProperties":false,"properties":{"min_speakers_expected":{"x-label":"Minimum speakers expected","description":"The minimum number of speakers expected in the audio file. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers) for more details.","type":"integer","default":1},"max_speakers_expected":{"x-label":"Maximum speakers expected","description":"<Warning>Setting this parameter too high may hurt model accuracy</Warning>\nThe maximum number of speakers expected in the audio file. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers) for more details.\n","type":"integer","default":10}}},"speakers_expected":{"x-label":"Speakers expected","description":"Tells the speaker label model how many speakers it should attempt to identify. See [Set number of speakers expected](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-number-of-speakers-expected) for more details.","type":"integer","default":null,"nullable":true},"speech_models":{"x-label":"Speech models","description":"List multiple speech models in priority order, allowing our system to automatically route your audio to the best available option. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models and routing behavior.\n","type":"array","items":{"x-label":"Speech model","type":"string","description":"The speech model to use for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","x-fern-sdk-group-name":"transcripts"}},"speech_threshold":{"x-label":"Speech threshold","description":"Reject audio files that contain less than this fraction of speech.\nValid values are in the range [0, 1] inclusive. See [Speech Threshold](https://www.assemblyai.com/docs/speech-threshold) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0,"nullable":true},"speech_understanding":{"x-label":"Speech Understanding","description":"Enable speech understanding tasks like [Translation](https://www.assemblyai.com/docs/speech-understanding/translation), [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification), and [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting). See the task-specific docs for available options and configuration.\n","type":"object","properties":{"request":{"oneOf":[{"x-label":"Translation request body","description":"Request body for [Translation](https://www.assemblyai.com/docs/speech-understanding/translation).","type":"object","properties":{"translation":{"type":"object","properties":{"target_languages":{"type":"array","items":{"type":"string"},"description":"List of target language codes (e.g., `[\"es\", \"de\"]`). See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for supported languages."},"formal":{"type":"boolean","description":"Use formal language style. See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for more details.","default":true},"match_original_utterance":{"type":"boolean","description":"When enabled with Speaker Labels, returns translated text in the utterances array. Each utterance will include a `translated_texts` key containing translations for each target language.","default":false}},"required":["target_languages"]}},"required":["translation"]},{"type":"object","description":"Request body for [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification).","properties":{"speaker_identification":{"type":"object","properties":{"speaker_type":{"type":"string","enum":["role","name"],"description":"Type of speaker identification. See [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification) for details on each type."},"known_values":{"type":"array","items":{"type":"string"},"description":"Required if speaker_type is \"role\". Each value must be 35 characters or less."},"speakers":{"type":"array","description":"An array of speaker objects with metadata to improve identification accuracy. Each object should include a `role` or `name` (depending on `speaker_type`) and an optional `description` to help the model identify the speaker. You can also include any additional custom properties (e.g., `company`, `title`) to provide more context. Use this as an alternative to `known_values` when you want to provide additional context about each speaker.","items":{"type":"object","properties":{"role":{"type":"string","description":"The role of the speaker. Required when `speaker_type` is \"role\"."},"name":{"type":"string","description":"The name of the speaker. Required when `speaker_type` is \"name\"."},"description":{"type":"string","description":"A description of the speaker to help the model identify them based on conversational context."}},"additionalProperties":true}}},"required":["speaker_type"]}},"required":["speaker_identification"]},{"type":"object","description":"Request body for [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting).","properties":{"custom_formatting":{"type":"object","properties":{"date":{"type":"string","description":"Date format pattern (e.g., `\"mm/dd/yyyy\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."},"phone_number":{"type":"string","description":"Phone number format pattern (e.g., `\"(xxx)xxx-xxxx\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."},"email":{"type":"string","description":"Email format pattern (e.g., `\"username@domain.com\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."}}}},"required":["custom_formatting"]}]}},"required":["request"]},"summarization":{"x-label":"Enable Summarization","description":"Enable [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization), can be true or false","type":"boolean","default":false},"summary_model":{"type":"string","x-label":"Summary model","description":"The model to summarize the transcript","x-fern-sdk-group-name":"transcripts","enum":["informative","conversational","catchy"],"x-aai-enum":{"informative":{"label":"Informative"},"conversational":{"label":"Conversational"},"catchy":{"label":"Catchy"}}},"summary_type":{"type":"string","x-label":"Summary type","description":"The type of summary","x-fern-sdk-group-name":"transcripts","enum":["bullets","bullets_verbose","gist","headline","paragraph"],"x-aai-enum":{"bullets":{"label":"Bullets"},"bullets_verbose":{"label":"Bullets verbose"},"gist":{"label":"Gist"},"headline":{"label":"Headline"},"paragraph":{"label":"Paragraph"}}},"temperature":{"x-label":"Temperature","description":"Control the amount of randomness injected into the model's response. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for more details.\n\nNote: This parameter can only be used with the Universal-3-Pro model.\n","type":"number","minimum":0,"maximum":1,"default":0},"webhook_auth_header_name":{"x-label":"Webhook auth header name","description":"The header name to be sent with the transcript completed or failed [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests","type":"string","default":null,"nullable":true},"webhook_auth_header_value":{"x-label":"Webhook auth header value","description":"The header value to send back with the transcript completed or failed [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests for added security","type":"string","default":null,"nullable":true},"webhook_url":{"x-label":"Webhook URL","description":"The URL to which we send [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests.\n","type":"string","format":"url"},"custom_topics":{"x-label":"Enable custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"boolean","default":false,"deprecated":true},"speech_model":{"x-label":"Speech model","description":"This parameter has been replaced with the `speech_models` parameter, learn more about the `speech_models` parameter [here](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model).\n","oneOf":[{"x-label":"Speech model","type":"string","description":"The speech model to use for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","x-fern-sdk-group-name":"transcripts"},{"type":"string","nullable":true}],"deprecated":true},"topics":{"x-label":"Custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"array","items":{"x-label":"Topic","type":"string"},"deprecated":true}},"type":"object","additionalProperties":false,"x-label":"Optional transcript parameters","description":"The parameters for creating a transcript","x-fern-sdk-group-name":"transcripts","example":{"speech_model":null,"language_code":"en_us","language_detection":true,"language_confidence_threshold":0.7,"punctuate":true,"format_text":true,"multichannel":true,"webhook_url":"https://your-webhook-url.tld/path","webhook_auth_header_name":"webhook-secret","webhook_auth_header_value":"webhook-secret-value","auto_highlights":true,"audio_start_from":10,"audio_end_at":280,"filter_profanity":true,"redact_pii":true,"redact_pii_audio":true,"redact_pii_audio_quality":"mp3","redact_pii_policies":["us_social_security_number","credit_card_number"],"redact_pii_sub":"hash","speaker_labels":true,"speakers_expected":2,"content_safety":true,"iab_categories":true,"custom_spelling":[],"disfluencies":false,"sentiment_analysis":true,"auto_chapters":true,"entity_detection":true,"speech_threshold":0.5,"summarization":true,"summary_model":"informative","summary_type":"bullets","custom_topics":true,"topics":[],"speech_understanding":{"request":{"translation":{"target_languages":["es","de"],"formal":true,"match_original_utterance":true}}}},"writeOnly":true},"deepgram_async":{"type":"object","properties":{"custom_topic":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"},"maxItems":100}]},"custom_topic_mode":{"default":"extended","type":"string","enum":["extended","strict"]},"custom_intent":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string","maxItems":100}}]},"custom_intent_mode":{"default":"extended","type":"string","enum":["extended","strict"]},"detect_entities":{"default":false,"type":"boolean"},"detect_language":{"oneOf":[{"type":"boolean","default":false},{"type":"array","items":{"type":"string"}}]},"diarize":{"default":false,"type":"boolean"},"dictation":{"default":false,"type":"boolean"},"encoding":{"type":"string","enum":["linear16","flac","mulaw","amr-nb","amr-wb","opus","speex","g729"]},"extra":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"filler_words":{"default":false,"type":"boolean"},"intents":{"default":false,"type":"boolean"},"keyterm":{"type":"array","items":{"type":"string"}},"keywords":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"language":{"type":"string","default":"en","enum":["bg","ca","zh","zh-CN","zh-TW","zh-HK","zh-Hans","zh-Hant","cs","da","da-DK","nl","nl-BE","en","en-US","en-AU","en-GB","en-NZ","en-IN","et","fi","fr","fr-CA","de","de-CH","el","hi","hi-Latn","hu","id","it","ja","ko","ko-KR","lv","lt","ms","multi","no","pl","pt","pt-BR","pt-PT","ro","ru","sk","es","es-419","es-LATAM","sv","sv-SE","taq","th","th-TH","tr","uk","vi"]},"measurements":{"default":false,"type":"boolean"},"mip_opt_out":{"default":false,"type":"boolean"},"model":{"default":"base-general","anyOf":[{"type":"string","description":"Our public models available to all accounts","enum":["nova-3","nova-3-general","nova-3-medical","nova-2","nova-2-general","nova-2-meeting","nova-2-finance","nova-2-conversationalai","nova-2-voicemail","nova-2-video","nova-2-medical","nova-2-drivethru","nova-2-automotive","nova","nova-general","nova-phonecall","nova-medical","enhanced","enhanced-general","enhanced-meeting","enhanced-phonecall","enhanced-finance","base","meeting","phonecall","finance","conversationalai","voicemail","video"]},{"type":"string","description":"Custom string if you've had a model trained by Deepgram"}],"example":"nova-3"},"multichannel":{"default":false,"type":"boolean"},"numerals":{"default":false,"type":"boolean"},"paragraphs":{"default":false,"type":"boolean"},"profanity_filter":{"default":false,"type":"boolean"},"punctuate":{"default":false,"type":"boolean"},"redact":{"default":false,"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string","enum":["pci","pii","numbers"]},"maxItems":100}]},"replace":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"search":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"sentiment":{"default":false,"type":"boolean"},"smart_format":{"default":false,"type":"boolean"},"summarize":{"type":"string","enum":["v1","v2","true","false"]},"tag":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"topics":{"default":false,"type":"boolean"},"utterances":{"default":false,"type":"boolean"},"utt_split":{"default":0.8,"type":"number"},"version":{"default":"latest","oneOf":[{"type":"string","description":"Use the latest version of a model","enum":["latest"]},{"type":"string","description":"Use a previous version of a model"}]}},"writeOnly":true},"gladia_v2_async":{"type":"object","properties":{"context_prompt":{"type":"string","description":"**[Deprecated]** Context to feed the transcription model with for possible better accuracy","deprecated":true},"custom_vocabulary":{"type":"boolean","description":"**[Beta]** Can be either boolean to enable custom_vocabulary for this audio or an array with specific vocabulary list to feed the transcription model with","default":false},"custom_vocabulary_config":{"properties":{"vocabulary":{"description":"Specific vocabulary list to feed the transcription model with. Each item can be a string or an object with the following properties: value, intensity, pronunciations, language.","example":["Westeros",{"value":"Stark"},{"value":"Night's Watch","pronunciations":["Nightz Watch"],"intensity":0.4,"language":"en"}],"type":"array","items":{"oneOf":[{"type":"object","properties":{"value":{"type":"string","description":"The text used to replace in the transcription.","example":"Gladia"},"intensity":{"type":"number","description":"The global intensity of the feature.","example":0.5,"minimum":0,"maximum":1},"pronunciations":{"description":"The pronunciations used in the transcription.","type":"array","items":{"type":"string"}},"language":{"type":"string","description":"Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.","example":"en"}},"required":["value"]},{"type":"string"}]}},"default_intensity":{"type":"number","description":"Default intensity for the custom vocabulary","example":0.5,"minimum":0,"maximum":1}},"required":["vocabulary"],"type":"object","description":"**[Beta]** Custom vocabulary configuration, if `custom_vocabulary` is enabled"},"detect_language":{"type":"boolean","description":"**[Deprecated]** Use `language_config` instead. Detect the language from the given audio","default":true,"deprecated":true},"enable_code_switching":{"type":"boolean","description":"**[Deprecated]** Use `language_config` instead.Detect multiple languages in the given audio","default":false,"deprecated":true},"code_switching_config":{"properties":{"languages":{"type":"array","description":"Specify the languages you want to use when detecting multiple languages","default":[],"items":{"type":"string","enum":["af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","ca","zh","hr","cs","da","nl","en","et","fo","fi","fr","gl","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","id","it","ja","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","mymr","ne","no","nn","oc","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","jp"]}}},"type":"object","description":"**[Deprecated]** Use `language_config` instead. Specify the configuration for code switching","deprecated":true},"language":{"type":"string","description":"**[Deprecated]** Use `language_config` instead. Set the spoken language for the given audio (ISO 639 standard)","deprecated":true,"enum":["af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","ca","zh","hr","cs","da","nl","en","et","fo","fi","fr","gl","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","id","it","ja","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","mymr","ne","no","nn","oc","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","jp"]},"callback_url":{"type":"string","description":"**[Deprecated]** Use `callback`/`callback_config` instead. Callback URL we will do a `POST` request to with the result of the transcription","example":"http://callback.example","format":"uri","deprecated":true},"callback":{"type":"boolean","description":"Enable callback for this transcription. If true, the `callback_config` property will be used to customize the callback behaviour","default":false},"callback_config":{"properties":{"url":{"type":"string","description":"The URL to be called with the result of the transcription","example":"http://callback.example","format":"uri"},"method":{"type":"string","description":"The HTTP method to be used. Allowed values are `POST` or `PUT` (default: `POST`)","default":"POST","enum":["POST","PUT"]}},"required":["url"],"type":"object","description":"Customize the callback behaviour (url and http method)"},"subtitles":{"type":"boolean","description":"Enable subtitles generation for this transcription","default":false},"subtitles_config":{"properties":{"formats":{"type":"array","minItems":1,"example":["srt"],"items":{"type":"string","description":"Subtitles formats you want your transcription to be formatted to","enum":["srt","vtt"]}},"minimum_duration":{"type":"number","description":"Minimum duration of a subtitle in seconds","minimum":0},"maximum_duration":{"type":"number","description":"Maximum duration of a subtitle in seconds","minimum":1,"maximum":30},"maximum_characters_per_row":{"type":"integer","description":"Maximum number of characters per row in a subtitle","minimum":1},"maximum_rows_per_caption":{"type":"integer","description":"Maximum number of rows per caption","minimum":1,"maximum":5},"style":{"type":"string","description":"Style of the subtitles. Compliance mode refers to : https://loc.gov/preservation/digital/formats//fdd/fdd000569.shtml#:~:text=SRT%20files%20are%20basic%20text,alongside%2C%20example%3A%20%22MyVideo123 ","default":"default","enum":["default","compliance"]}},"type":"object","description":"Configuration for subtitles generation if `subtitles` is enabled"},"diarization":{"type":"boolean","description":"Enable speaker recognition (diarization) for this audio","default":false},"diarization_config":{"properties":{"number_of_speakers":{"type":"integer","description":"Exact number of speakers in the audio","example":3,"minimum":1},"min_speakers":{"type":"integer","description":"Minimum number of speakers in the audio","example":1,"minimum":0},"max_speakers":{"type":"integer","description":"Maximum number of speakers in the audio","example":2,"minimum":0},"enhanced":{"type":"boolean","description":"**[Alpha]** Use enhanced diarization for this audio","default":false}},"type":"object","description":"Speaker recognition configuration, if `diarization` is enabled"},"translation":{"type":"boolean","description":"**[Beta]** Enable translation for this audio","default":false},"translation_config":{"properties":{"target_languages":{"type":"array","example":["en"],"minItems":1,"items":{"type":"string","description":"The target language in `iso639-1` format","enum":["af","sq","am","ar","hy","as","ast","az","ba","eu","be","bn","bs","br","bg","my","ca","ceb","zh","hr","cs","da","nl","en","et","fo","fi","nl","fr","fy","ff","gd","gl","lg","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","ig","ilo","id","ga","it","ja","jp","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mo","mn","mymr","ne","no","nn","oc","or","pa","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","ss","sv","tl","tg","ta","tt","te","th","bo","tn","tr","tk","uk","ur","uz","vi","cy","wo","xh","yi","yo","zu"]}},"model":{"type":"string","description":"Model you want the translation model to use to translate","default":"base","enum":["base","enhanced"]},"match_original_utterances":{"type":"boolean","description":"Align translated utterances with the original ones","default":true},"lipsync":{"type":"boolean","description":"Whether to apply lipsync to the translated transcription. ","default":true},"context_adaptation":{"type":"boolean","description":"Enables or disables context-aware translation features that allow the model to adapt translations based on provided context.","default":true},"context":{"type":"string","description":"Context information to improve translation accuracy"},"informal":{"type":"boolean","description":"Forces the translation to use informal language forms when available in the target language.","default":false}},"required":["target_languages"],"type":"object","description":"**[Beta]** Translation configuration, if `translation` is enabled"},"summarization":{"type":"boolean","description":"**[Beta]** Enable summarization for this audio","default":false},"summarization_config":{"properties":{"type":{"type":"string","description":"The type of summarization to apply","default":"general","enum":["general","bullet_points","concise"]}},"type":"object","description":"**[Beta]** Summarization configuration, if `summarization` is enabled"},"moderation":{"type":"boolean","description":"**[Alpha]** Enable moderation for this audio","default":false},"named_entity_recognition":{"type":"boolean","description":"**[Alpha]** Enable named entity recognition for this audio","default":false},"chapterization":{"type":"boolean","description":"**[Alpha]** Enable chapterization for this audio","default":false},"name_consistency":{"type":"boolean","description":"**[Alpha]** Enable names consistency for this audio","default":false},"custom_spelling":{"type":"boolean","description":"**[Alpha]** Enable custom spelling for this audio","default":false},"custom_spelling_config":{"properties":{"spelling_dictionary":{"type":"object","description":"The list of spelling applied on the audio transcription","example":{"Gettleman":["gettleman"],"SQL":["Sequel"]}}},"required":["spelling_dictionary"],"type":"object","description":"**[Alpha]** Custom spelling configuration, if `custom_spelling` is enabled"},"structured_data_extraction":{"type":"boolean","description":"**[Alpha]** Enable structured data extraction for this audio","default":false},"structured_data_extraction_config":{"properties":{"classes":{"description":"The list of classes to extract from the audio transcription","example":["Persons","Organizations"],"minItems":1,"type":"array","items":{"type":"array","items":{"type":"string"}}}},"required":["classes"],"type":"object","description":"**[Alpha]** Structured data extraction configuration, if `structured_data_extraction` is enabled"},"sentiment_analysis":{"type":"boolean","description":"**[Alpha]** Enable sentiment analysis for this audio","default":false},"audio_to_llm":{"type":"boolean","description":"**[Alpha]** Enable audio to llm processing for this audio","default":false},"audio_to_llm_config":{"properties":{"prompts":{"description":"The list of prompts applied on the audio transcription","example":["Extract the key points from the transcription"],"minItems":1,"type":"array","items":{"type":"array","items":{"type":"string"}}}},"required":["prompts"],"type":"object","description":"**[Alpha]** Audio to llm configuration, if `audio_to_llm` is enabled"},"custom_metadata":{"type":"object","description":"Custom metadata you can attach to this transcription"},"sentences":{"type":"boolean","description":"Enable sentences for this audio","default":false},"display_mode":{"type":"boolean","description":"**[Alpha]** Allows to change the output display_mode for this audio. The output will be reordered, creating new utterances when speakers overlapped","default":false},"punctuation_enhanced":{"type":"boolean","description":"**[Alpha]** Use enhanced punctuation for this audio","default":false},"language_config":{"properties":{"languages":{"type":"array","description":"If one language is set, it will be used for the transcription. Otherwise, language will be auto-detected by the model.","default":[],"items":{"type":"string","enum":["af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","ca","zh","hr","cs","da","nl","en","et","fo","fi","fr","gl","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","id","it","ja","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","mymr","ne","no","nn","oc","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","jp"]}},"code_switching":{"type":"boolean","description":"If true, language will be auto-detected on each utterance. Otherwise, language will be auto-detected on first utterance and then used for the rest of the transcription. If one language is set, this option will be ignored.","default":false}},"type":"object","description":"Specify the language configuration"}},"writeOnly":true},"recallai_async":{"$ref":"#/components/schemas/RecallaiAsyncTranscriptionRequest"},"rev_async":{"type":"object","properties":{"metadata":{"maxLength":512,"minLength":0,"type":"string","description":"Optional metadata for the job","nullable":true},"delete_after":{"type":"string","description":"Optional setting for the number of Seconds after job completion\r\nwhen the job should be auto-deleted","format":"date-span","nullable":true},"language":{"type":"string","description":"Optional language setting for foreign languages","nullable":true},"skip_diarization":{"type":"boolean","description":"Optional setting for turning on/off diarization.\r\nIf not set, we will assume the value is false.","nullable":true},"skip_postprocessing":{"type":"boolean","description":"Optional setting for turning on/off postprocessing.\r\nIf not set, we will assume the value is false.","nullable":true},"custom_vocabularies":{"maxItems":50,"type":"array","items":{"required":["phrases"],"type":"object","properties":{"phrases":{"maxItems":20000,"minItems":1,"type":"array","items":{"type":"string"}}},"additionalProperties":false},"description":"Optional setting for passing in custom vocabularies.","nullable":true},"custom_vocabulary_id":{"type":"string","description":"The id of the prebuilt custom vocabulary job","nullable":true},"strict_custom_vocabulary":{"type":"boolean","description":"If true, only exact phrases submitted in the Rev.Ai.Api.Models.SubmitJobOptions.CustomVocabularies option will be used as custom vocabulary,\r\ni.e. phrases will not be split into individual words for processing.\r\nDefaults to true if Rev.Ai.Api.Models.SubmitJobOptions.CustomVocabularies is set.","nullable":true},"skip_punctuation":{"type":"boolean","description":"Optional setting for disabling punctuation.\r\nIf unset, the value is assumed to be false.","nullable":true},"remove_disfluencies":{"type":"boolean","description":"Optional setting for removing disfluencies\r\nIf unset the value is assumed to be false","nullable":true},"remove_atmospherics":{"type":"boolean","description":"Optional setting for removing atmospherics\r\nIf unset the value is assumed to be false","nullable":true},"filter_profanity":{"type":"boolean","description":"Optional setting for removing profanities\r\nIf unset the value is assumed to be false","nullable":true},"add_data_labels":{"type":"boolean","description":"Optional setting for adding data classification labels\r\nIf unset the value is assumed to be false","nullable":true},"enable_redaction":{"type":"boolean","description":"Optional setting for redacting certain data labels\r\nIf unset the value is assumed to be false","nullable":true},"speaker_channels_count":{"maximum":8,"minimum":1,"type":"integer","description":"Optional speaker channels count used to indicate how many individual channels\r\nto transcribe for a given audio","format":"int32","nullable":true},"speakers_count":{"maximum":2147483647,"minimum":1,"type":"integer","description":"Optional count of speakers in the audio to improve diarization accuracy","format":"int32","nullable":true},"alternatives_count":{"maximum":3,"minimum":0,"type":"integer","description":"Optional count of alternatives to generate","format":"int32","nullable":true},"deletion_length_penalty":{"maximum":100,"minimum":-100,"type":"integer","format":"int32","nullable":true},"chunk_size":{"type":"string","description":"Optional chunk size to be sent to Revspeech for processing","format":"date-span","nullable":true},"transcriber":{"enum":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17],"type":"integer","format":"int32"},"verbatim":{"type":"boolean","description":"Instructs Revver to transcribe audio with all details including disfluencies and other verbal interactions\r\nsuch as laughter","nullable":true},"rush":{"type":"boolean","description":"Whether human order should be rushed at a greater cost to the customer","nullable":true},"segments_to_transcribe":{"type":"array","items":{"required":["end","start"],"type":"object","properties":{"start":{"type":"string","format":"date-span"},"end":{"type":"string","format":"date-span"}},"additionalProperties":false},"description":"Specific segments of the file to be transcribed by a human","nullable":true},"test_mode":{"type":"boolean","description":"Whether human order is test mode and should return a dummy transcript","nullable":true},"speaker_names":{"type":"array","items":{"required":["displayName"],"type":"object","properties":{"display_name":{"maxLength":50,"minLength":1,"type":"string"}},"additionalProperties":false},"description":"Speaker names for human transcription","nullable":true},"predict_topics":{"type":"boolean","description":"Whether to predict topics while performing speech rec","nullable":true},"top_nwords":{"maximum":100,"minimum":0,"type":"integer","description":"Returns the top n words of a transcript. Defaults to 0","format":"int32","nullable":true},"forced_alignment":{"type":"boolean","description":"Whether improved alignment should be used with transcription","nullable":true},"enable_fusion":{"type":"boolean","description":"Whether transcription should be done with fusion","nullable":true},"domain":{"enum":[0,1],"type":"integer","format":"int32"},"apply_duration_padding":{"type":"boolean","description":"If set adds one second of silence to the audio at the end","nullable":true},"diarization_type":{"enum":[0,10,20],"type":"integer","format":"int32"},"summarization_config":{"type":"object","properties":{"prompt":{"type":"string","description":"User defined prompt.","nullable":true},"model":{"enum":[0,1],"type":"integer","description":"Summarization model options for Rev.ai API","format":"int32"},"type":{"enum":[0,1],"type":"integer","description":"Summarization formatting options.","format":"int32"}},"additionalProperties":false,"description":"Summarization options."},"captions_config":{"type":"object","additionalProperties":false,"description":"Caption options."},"translation_config":{"required":["targetLanguages"],"type":"object","properties":{"target_languages":{"maxItems":5,"minItems":1,"type":"array","items":{"required":["language"],"type":"object","properties":{"model":{"enum":[0,1],"type":"integer","description":"Defines the type of models supported to translated the content","format":"int32"},"language":{"minLength":1,"type":"string","description":"Target language"}},"additionalProperties":false,"description":"Options for translation as part of Async job request for specific target language"},"description":"Target languages"}},"additionalProperties":false,"description":"Options for translation as part of Async job request"}},"additionalProperties":false,"writeOnly":true},"speechmatics_async":{"description":"JSON object that contains various groups of job configuration\nparameters. Based on the value of `type`, a type-specific object\nsuch as `transcription_config` is required to be present to\nspecify all configuration settings or parameters needed to\nprocess the job inputs as expected.\n\nIf the results of the job are to be forwarded on completion,\n`notification_config` can be provided with a list of callbacks\nto be made; no assumptions should be made about the order in\nwhich they will occur.\n\nCustomer specific job details or metadata can be supplied in\n`tracking`, and this information will be available where\npossible in the job results and in callbacks.\n","properties":{"alignment_config":{"required":["language"],"properties":{"language":{"type":"string"}},"example":{"language":"en"}},"transcription_config":{"required":["language"],"properties":{"language":{"type":"string","description":"Language model to process the audio input, normally specified as an ISO language code"},"domain":{"type":"string","description":"Request a specialized model based on 'language' but optimized for a particular field, e.g. \"finance\" or \"medical\"."},"output_locale":{"type":"string","description":"Language locale to be used when generating the transcription output, normally specified as an ISO language code"},"operating_point":{"type":"string","enum":["standard","enhanced"]},"additional_vocab":{"type":"array","x-omitempty":true,"items":{"type":"object","required":["content"],"properties":{"content":{"type":"string"},"sounds_like":{"type":"array","x-omitempty":true,"items":{"type":"string"}}}},"description":"List of custom words or phrases that should be recognized. Alternative pronunciations can be specified to aid recognition."},"punctuation_overrides":{"properties":{"sensitivity":{"type":"number","format":"float","minimum":0,"maximum":1,"description":"Ranges between zero and one. Higher values will produce more punctuation. The default is 0.5."},"permitted_marks":{"type":"array","items":{"type":"string","pattern":"^(.|all)$"},"description":"The punctuation marks which the client is prepared to accept in transcription output, or the special value 'all' (the default). Unsupported marks are ignored. This value is used to guide the transcription process."}},"description":"Control punctuation settings."},"diarization":{"type":"string","enum":["none","speaker","channel"],"description":"Specify whether speaker or channel labels are added to the transcript.\nThe default is `none`.\n  - **none**: no speaker or channel labels are added.\n  - **speaker**: speaker attribution is performed based on acoustic matching;\n             all input channels are mixed into a single stream for processing.\n  - **channel**: multiple input channels are processed individually and collated\n            into a single transcript."},"channel_diarization_labels":{"type":"array","x-omitempty":true,"items":{"type":"string","pattern":"^[A-Za-z0-9._]+$"},"description":"Transcript labels to use when using collating separate input channels."},"enable_entities":{"type":"boolean","description":"Include additional 'entity' objects in the transcription results (e.g. dates, numbers) and their original spoken form. These entities are interleaved with other types of results. The concatenation of these words is represented as a single entity with the concatenated written form present in the 'content' field. The entities contain a 'spoken_form' field, which can be used in place of the corresponding 'word' type results, in case a spoken form is preferred to a written form. They also contain a 'written_form', which can be used instead of the entity, if you want a breakdown of the words without spaces. They can still contain non-breaking spaces and other special whitespace characters, as they are considered part of the word for the formatting output. In case of a written_form, the individual word times are estimated and might not be accurate if the order of the words in the written form does not correspond to the order they were actually spoken (such as 'one hundred million dollars' and '$100 million')."},"max_delay_mode":{"type":"string","enum":["fixed","flexible"],"description":"Whether or not to enable flexible endpointing and allow the entity to continue to be spoken."},"transcript_filtering_config":{"description":"Configuration for applying filtering to the transcription","properties":{"remove_disfluencies":{"type":"boolean","description":"If true, words that are identified as disfluencies will be removed from the transcript. If false (default), they are tagged in the transcript as 'disfluency'."},"replacements":{"type":"array","x-omitempty":true,"items":{"additionalProperties":false,"type":"object","required":["from","to"],"properties":{"from":{"type":"string"},"to":{"type":"string"}}},"description":"A list of replacements to apply to the transcript. Each replacement is a pair of strings, where the first string is the pattern to be replaced and the second string is the replacement text."}}},"speaker_diarization_config":{"description":"Configuration for speaker diarization","properties":{"prefer_current_speaker":{"type":"boolean","description":"If true, the algorithm will prefer to stay with the current active speaker if it is a close enough match, even if other speakers may be closer.  This is useful for cases where we can flip incorrectly between similar speakers during a single speaker section.\""},"speaker_sensitivity":{"type":"number","format":"float","minimum":0,"maximum":1,"description":"Controls how sensitive the algorithm is in terms of keeping similar speakers separate, as opposed to combining them into a single speaker.  Higher values will typically lead to more speakers, as the degree of difference between speakers in order to allow them to remain distinct will be lower.  A lower value for this parameter will conversely guide the algorithm towards being less sensitive in terms of retaining similar speakers, and as such may lead to fewer speakers overall.  The default is 0.5."}}}},"example":{"language":"en","output_locale":"en-GB","additional_vocab":[{"content":"Speechmatics","sounds_like":["speechmatics"]},{"content":"gnocchi","sounds_like":["nyohki","nokey","nochi"]},{"content":"CEO","sounds_like":["C.E.O."]},{"content":"financial crisis"}],"diarization":"channel","channel_diarization_labels":["Caller","Agent"]}},"tracking":{"properties":{"title":{"type":"string","description":"The title of the job."},"reference":{"type":"string","description":"External system reference."},"tags":{"type":"array","x-omitempty":true,"items":{"type":"string"}},"details":{"type":"object","description":"Customer-defined JSON structure."}},"example":{"title":"ACME Q12018 Earnings Call","reference":"/data/clients/ACME/statements/segs/2018Q1-seg8","tags":["quick-review","segment"],"details":{"client":"ACME Corp","segment":8,"seg_start":963.201,"seg_end":1091.481}}},"output_config":{"x-omitempty":true,"type":"object","properties":{"srt_overrides":{"description":"Parameters that override default values of srt conversion. max_line_length: sets maximum count of characters per subtitle line including white space. max_lines: sets maximum count of lines in a subtitle section.","type":"object","properties":{"max_line_length":{"type":"integer"},"max_lines":{"type":"integer"}}}}},"translation_config":{"required":["target_languages"],"properties":{"target_languages":{"type":"array","maxItems":5,"items":{"type":"string"}}}},"language_identification_config":{"properties":{"expected_languages":{"type":"array","x-omitempty":true,"items":{"type":"string"}},"low_confidence_action":{"type":"string","enum":["allow","reject","use_default_language"],"description":"Action to take if all of the predicted languages are below the confidence threshold"},"default_language":{"type":"string"}}},"summarization_config":{"properties":{"content_type":{"type":"string","enum":["auto","informative","conversational"]},"summary_length":{"type":"string","enum":["brief","detailed"]},"summary_type":{"type":"string","enum":["paragraphs","bullets"]}}},"sentiment_analysis_config":{"type":"object"},"topic_detection_config":{"properties":{"topics":{"x-omitempty":true,"type":"array","items":{"type":"string"}}}},"auto_chapters_config":{"type":"object"},"audio_events_config":{"x-omitempty":true,"type":"object","properties":{"types":{"x-omitempty":true,"type":"array","items":{"type":"string"}}}}},"writeOnly":true},"google_speech_v2_async":{"description":"Request message for the BatchRecognize method.","type":"object","properties":{"recognizer":{"description":"Required. The name of the Recognizer to use during recognition. The expected format is `projects/{project}/locations/{location}/recognizers/{recognizer}`. The {recognizer} segment may be set to `_` to use an empty implicit Recognizer.","type":"string","default":"projects/{project_id}/locations/global/recognizers/_"},"config":{"description":"Provides information to the Recognizer that specifies how to process the recognition request.","type":"object","properties":{"autoDecodingConfig":{"description":"Automatically detected decoding parameters. Supported for the following encodings: * WAV_LINEAR16: 16-bit signed little-endian PCM samples in a WAV container. * WAV_MULAW: 8-bit companded mulaw samples in a WAV container. * WAV_ALAW: 8-bit companded alaw samples in a WAV container. * RFC4867_5_AMR: AMR frames with an rfc4867.5 header. * RFC4867_5_AMRWB: AMR-WB frames with an rfc4867.5 header. * FLAC: FLAC frames in the \"native FLAC\" container format. * MP3: MPEG audio frames with optional (ignored) ID3 metadata. * OGG_OPUS: Opus audio frames in an Ogg container. * WEBM_OPUS: Opus audio frames in a WebM container. * MP4_AAC: AAC audio frames in an MP4 container. * M4A_AAC: AAC audio frames in an M4A container. * MOV_AAC: AAC audio frames in an MOV container.","type":"object","properties":{}},"explicitDecodingConfig":{"description":"Explicitly specified decoding parameters.","type":"object","properties":{"encoding":{"description":"Required. Encoding of the audio data sent for recognition.","type":"string","enum":["AUDIO_ENCODING_UNSPECIFIED","LINEAR16","MULAW","ALAW","AMR","AMR_WB","FLAC","MP3","OGG_OPUS","WEBM_OPUS","MP4_AAC","M4A_AAC","MOV_AAC"]},"sampleRateHertz":{"description":"Optional. Sample rate in Hertz of the audio data sent for recognition. Valid values are: 8000-48000, and 16000 is optimal. For best results, set the sampling rate of the audio source to 16000 Hz. If that's not possible, use the native sample rate of the audio source (instead of resampling). Note that this field is marked as OPTIONAL for backward compatibility reasons. It is (and has always been) effectively REQUIRED.","type":"integer","format":"int32"},"audioChannelCount":{"description":"Optional. Number of channels present in the audio data sent for recognition. Note that this field is marked as OPTIONAL for backward compatibility reasons. It is (and has always been) effectively REQUIRED. The maximum allowed value is 8.","type":"integer","format":"int32"}}},"model":{"description":"Optional. Which model to use for recognition requests. Select the model best suited to your domain to get best results. Guidance for choosing which model to use can be found in the [Transcription Models Documentation](https://cloud.google.com/speech-to-text/v2/docs/transcription-model) and the models supported in each region can be found in the [Table Of Supported Models](https://cloud.google.com/speech-to-text/v2/docs/speech-to-text-supported-languages).","type":"string"},"languageCodes":{"description":"Optional. The language of the supplied audio as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. Language tags are normalized to BCP-47 before they are used eg \"en-us\" becomes \"en-US\". Supported languages for each model are listed in the [Table of Supported Models](https://cloud.google.com/speech-to-text/v2/docs/speech-to-text-supported-languages). If additional languages are provided, recognition result will contain recognition in the most likely language detected. The recognition result will include the language tag of the language detected in the audio.","type":"array","items":{"type":"string"}},"features":{"description":"Available recognition features.","type":"object","properties":{"profanityFilter":{"description":"If set to `true`, the server will attempt to filter out profanities, replacing all but the initial character in each filtered word with asterisks, for instance, \"f***\". If set to `false` or omitted, profanities won't be filtered out.","type":"boolean"},"enableWordTimeOffsets":{"description":"If `true`, the top result includes a list of words and the start and end time offsets (timestamps) for those words. If `false`, no word-level time offset information is returned. The default is `false`.","type":"boolean"},"enableWordConfidence":{"description":"If `true`, the top result includes a list of words and the confidence for those words. If `false`, no word-level confidence information is returned. The default is `false`.","type":"boolean"},"enableAutomaticPunctuation":{"description":"If `true`, adds punctuation to recognition result hypotheses. This feature is only available in select languages. The default `false` value does not add punctuation to result hypotheses.","type":"boolean"},"enableSpokenPunctuation":{"description":"The spoken punctuation behavior for the call. If `true`, replaces spoken punctuation with the corresponding symbols in the request. For example, \"how are you question mark\" becomes \"how are you?\". See https://cloud.google.com/speech-to-text/docs/spoken-punctuation for support. If `false`, spoken punctuation is not replaced.","type":"boolean"},"enableSpokenEmojis":{"description":"The spoken emoji behavior for the call. If `true`, adds spoken emoji formatting for the request. This will replace spoken emojis with the corresponding Unicode symbols in the final transcript. If `false`, spoken emojis are not replaced.","type":"boolean"},"multiChannelMode":{"description":"Mode for recognizing multi-channel audio.","type":"string","enum":["MULTI_CHANNEL_MODE_UNSPECIFIED","SEPARATE_RECOGNITION_PER_CHANNEL"]},"diarizationConfig":{"description":"Configuration to enable speaker diarization.","type":"object","properties":{"minSpeakerCount":{"description":"Optional. The system automatically determines the number of speakers. This value is not currently used.","type":"integer","format":"int32"},"maxSpeakerCount":{"description":"Optional. The system automatically determines the number of speakers. This value is not currently used.","type":"integer","format":"int32"}}},"maxAlternatives":{"description":"Maximum number of recognition hypotheses to be returned. The server may return fewer than `max_alternatives`. Valid values are `0`-`30`. A value of `0` or `1` will return a maximum of one. If omitted, will return a maximum of one.","type":"integer","format":"int32"}}},"adaptation":{"description":"Provides \"hints\" to the speech recognizer to favor specific words and phrases in the results. PhraseSets can be specified as an inline resource, or a reference to an existing PhraseSet resource.","type":"object","properties":{"phraseSets":{"description":"A list of inline or referenced PhraseSets.","type":"array","items":{"description":"A biasing PhraseSet, which can be either a string referencing the name of an existing PhraseSets resource, or an inline definition of a PhraseSet.","type":"object","properties":{"phraseSet":{"description":"The name of an existing PhraseSet resource. The user must have read access to the resource and it must not be deleted.","type":"string"},"inlinePhraseSet":{"description":"PhraseSet for biasing in speech recognition. A PhraseSet is used to provide \"hints\" to the speech recognizer to favor specific words and phrases in the results.","type":"object","properties":{"name":{"description":"Output only. Identifier. The resource name of the PhraseSet. Format: `projects/{project}/locations/{location}/phraseSets/{phrase_set}`.","readOnly":true,"type":"string"},"uid":{"description":"Output only. System-assigned unique identifier for the PhraseSet.","readOnly":true,"type":"string"},"phrases":{"description":"A list of word and phrases.","type":"array","items":{"description":"A Phrase contains words and phrase \"hints\" so that the speech recognition is more likely to recognize them. This can be used to improve the accuracy for specific words and phrases, for example, if specific commands are typically spoken by the user. This can also be used to add additional words to the vocabulary of the recognizer. List items can also include CustomClass references containing groups of words that represent common concepts that occur in natural language.","type":"object","properties":{"value":{"description":"The phrase itself.","type":"string"},"boost":{"description":"Hint Boost. Overrides the boost set at the phrase set level. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost values would correspond to anti-biasing. Anti-biasing is not enabled, so negative boost values will return an error. Boost values must be between 0 and 20. Any values outside that range will return an error. We recommend using a binary search approach to finding the optimal value for your use case as well as adding phrases both with and without boost to your requests.","type":"number","format":"float"}}}},"boost":{"description":"Hint Boost. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Valid `boost` values are between 0 (exclusive) and 20. We recommend using a binary search approach to finding the optimal value for your use case as well as adding phrases both with and without boost to your requests.","type":"number","format":"float"},"displayName":{"description":"User-settable, human-readable name for the PhraseSet. Must be 63 characters or less.","type":"string"},"state":{"description":"Output only. The PhraseSet lifecycle state.","readOnly":true,"type":"string","enum":["STATE_UNSPECIFIED","ACTIVE","DELETED"]},"createTime":{"description":"Output only. Creation time.","readOnly":true,"type":"string","format":"google-datetime"},"updateTime":{"description":"Output only. The most recent time this resource was modified.","readOnly":true,"type":"string","format":"google-datetime"},"deleteTime":{"description":"Output only. The time at which this resource was requested for deletion.","readOnly":true,"type":"string","format":"google-datetime"},"expireTime":{"description":"Output only. The time at which this resource will be purged.","readOnly":true,"type":"string","format":"google-datetime"},"annotations":{"description":"Allows users to store small amounts of arbitrary data. Both the key and the value must be 63 characters or less each. At most 100 annotations.","type":"object","additionalProperties":{"type":"string"}},"etag":{"description":"Output only. This checksum is computed by the server based on the value of other fields. This may be sent on update, undelete, and delete requests to ensure the client has an up-to-date value before proceeding.","readOnly":true,"type":"string"},"reconciling":{"description":"Output only. Whether or not this PhraseSet is in the process of being updated.","readOnly":true,"type":"boolean"},"kmsKeyName":{"description":"Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.","readOnly":true,"type":"string"},"kmsKeyVersionName":{"description":"Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.","readOnly":true,"type":"string"}}}}}},"customClasses":{"description":"A list of inline CustomClasses. Existing CustomClass resources can be referenced directly in a PhraseSet.","type":"array","items":{"description":"CustomClass for biasing in speech recognition. Used to define a set of words or phrases that represents a common concept or theme likely to appear in your audio, for example a list of passenger ship names.","type":"object","properties":{"name":{"description":"Output only. Identifier. The resource name of the CustomClass. Format: `projects/{project}/locations/{location}/customClasses/{custom_class}`.","readOnly":true,"type":"string"},"uid":{"description":"Output only. System-assigned unique identifier for the CustomClass.","readOnly":true,"type":"string"},"displayName":{"description":"Optional. User-settable, human-readable name for the CustomClass. Must be 63 characters or less.","type":"string"},"items":{"description":"A collection of class items.","type":"array","items":{"description":"An item of the class.","type":"object","properties":{"value":{"description":"The class item's value.","type":"string"}}}},"state":{"description":"Output only. The CustomClass lifecycle state.","readOnly":true,"type":"string","enum":["STATE_UNSPECIFIED","ACTIVE","DELETED"]},"createTime":{"description":"Output only. Creation time.","readOnly":true,"type":"string","format":"google-datetime"},"updateTime":{"description":"Output only. The most recent time this resource was modified.","readOnly":true,"type":"string","format":"google-datetime"},"deleteTime":{"description":"Output only. The time at which this resource was requested for deletion.","readOnly":true,"type":"string","format":"google-datetime"},"expireTime":{"description":"Output only. The time at which this resource will be purged.","readOnly":true,"type":"string","format":"google-datetime"},"annotations":{"description":"Optional. Allows users to store small amounts of arbitrary data. Both the key and the value must be 63 characters or less each. At most 100 annotations.","type":"object","additionalProperties":{"type":"string"}},"etag":{"description":"Output only. This checksum is computed by the server based on the value of other fields. This may be sent on update, undelete, and delete requests to ensure the client has an up-to-date value before proceeding.","readOnly":true,"type":"string"},"reconciling":{"description":"Output only. Whether or not this CustomClass is in the process of being updated.","readOnly":true,"type":"boolean"},"kmsKeyName":{"description":"Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the CustomClass is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.","readOnly":true,"type":"string"},"kmsKeyVersionName":{"description":"Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which the CustomClass is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.","readOnly":true,"type":"string"}}}}}},"transcriptNormalization":{"description":"Transcription normalization configuration. Use transcription normalization to automatically replace parts of the transcript with phrases of your choosing. For StreamingRecognize, this normalization only applies to stable partial transcripts (stability > 0.8) and final transcripts.","type":"object","properties":{"entries":{"description":"A list of replacement entries. We will perform replacement with one entry at a time. For example, the second entry in [\"cat\" => \"dog\", \"mountain cat\" => \"mountain dog\"] will never be applied because we will always process the first entry before it. At most 100 entries.","type":"array","items":{"description":"A single replacement configuration.","type":"object","properties":{"search":{"description":"What to replace. Max length is 100 characters.","type":"string"},"replace":{"description":"What to replace with. Max length is 100 characters.","type":"string"},"caseSensitive":{"description":"Whether the search is case sensitive.","type":"boolean"}}}}}},"translationConfig":{"description":"Translation configuration. Use to translate the given audio into text for the desired language.","type":"object","properties":{"targetLanguage":{"description":"Required. The language code to translate to.","type":"string"}}},"denoiserConfig":{"description":"Denoiser config. May not be supported for all models and may have no effect.","type":"object","properties":{"denoiseAudio":{"description":"Denoise audio before sending to the transcription model.","type":"boolean"},"snrThreshold":{"description":"Signal-to-Noise Ratio (SNR) threshold for the denoiser. Here SNR means the loudness of the speech signal. Audio with an SNR below this threshold, meaning the speech is too quiet, will be prevented from being sent to the transcription model. If snr_threshold=0, no filtering will be applied.","type":"number","format":"float"}}}}},"configMask":{"description":"The list of fields in config that override the values in the default_recognition_config of the recognizer during this recognition request. If no mask is provided, all given fields in config override the values in the recognizer for this recognition request. If a mask is provided, only the fields listed in the mask override the config in the recognizer for this recognition request. If a wildcard (`*`) is provided, config completely overrides and replaces the config in the recognizer for this recognition request.","type":"string","format":"google-fieldmask"}},"writeOnly":true},"aws_transcribe_async":{"type":"object","writeOnly":true,"description":"AWS Transcribe batch transcription. Docs: https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html"},"elevenlabs_async":{"properties":{"model_id":{"type":"string","enum":["scribe_v1","scribe_v2"],"title":"Model Id","description":"The ID of the model to use for transcription."},"language_code":{"anyOf":[{"type":"string"},{"type":"string","nullable":true}],"title":"Language Code","description":"An ISO-639-1 or ISO-639-3 language_code corresponding to the language of the audio file. Can sometimes improve transcription performance if known beforehand. Defaults to null, in this case the language is predicted automatically."},"tag_audio_events":{"type":"boolean","title":"Tag Audio Events","description":"Whether to tag audio events like (laughter), (footsteps), etc. in the transcription.","default":true},"num_speakers":{"anyOf":[{"type":"integer","maximum":32,"minimum":1},{"type":"string","nullable":true}],"title":"Num Speakers","description":"The maximum amount of speakers talking in the uploaded file. Can help with predicting who speaks when. The maximum amount of speakers that can be predicted is 32. Defaults to null, in this case the amount of speakers is set to the maximum value the model supports."},"diarize":{"type":"boolean","title":"Diarize","description":"Whether to annotate which speaker is currently talking in the uploaded file.","default":false},"diarization_threshold":{"anyOf":[{"type":"number","maximum":0.4,"minimum":0.1},{"type":"string","nullable":true}],"title":"Diarization Threshold","description":"Diarization threshold to apply during speaker diarization. A higher value means there will be a lower chance of one speaker being diarized as two different speakers but also a higher chance of two different speakers being diarized as one speaker (less total speakers predicted). A low value means there will be a higher chance of one speaker being diarized as two different speakers but also a lower chance of two different speakers being diarized as one speaker (more total speakers predicted). Can only be set when diarize=True and num_speakers=None. Defaults to None, in which case we will choose a threshold based on the model_id (0.22 usually)."},"additional_formats":{"items":{"oneOf":[{"properties":{"include_speakers":{"type":"boolean","title":"Include Speakers","default":true},"include_timestamps":{"type":"boolean","title":"Include Timestamps","default":true},"format":{"type":"string","title":"Format","enum":["segmented_json"]},"segment_on_silence_longer_than_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Segment On Silence Longer Than S"},"max_segment_duration_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Max Segment Duration S"},"max_segment_chars":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Segment Chars"}},"type":"object","required":["format"],"title":"SegmentedJsonExportOptions"},{"properties":{"include_speakers":{"type":"boolean","title":"Include Speakers","default":true},"include_timestamps":{"type":"boolean","title":"Include Timestamps","default":true},"format":{"type":"string","title":"Format","enum":["docx"]},"segment_on_silence_longer_than_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Segment On Silence Longer Than S"},"max_segment_duration_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Max Segment Duration S"},"max_segment_chars":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Segment Chars"}},"type":"object","required":["format"],"title":"DocxExportOptions"},{"properties":{"include_speakers":{"type":"boolean","title":"Include Speakers","default":true},"include_timestamps":{"type":"boolean","title":"Include Timestamps","default":true},"format":{"type":"string","title":"Format","enum":["pdf"]},"segment_on_silence_longer_than_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Segment On Silence Longer Than S"},"max_segment_duration_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Max Segment Duration S"},"max_segment_chars":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Segment Chars"}},"type":"object","required":["format"],"title":"PdfExportOptions"},{"properties":{"max_characters_per_line":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Characters Per Line","default":100},"include_speakers":{"type":"boolean","title":"Include Speakers","default":true},"include_timestamps":{"type":"boolean","title":"Include Timestamps","default":true},"format":{"type":"string","title":"Format","enum":["txt"]},"segment_on_silence_longer_than_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Segment On Silence Longer Than S"},"max_segment_duration_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Max Segment Duration S"},"max_segment_chars":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Segment Chars"}},"type":"object","required":["format"],"title":"TxtExportOptions"},{"properties":{"include_speakers":{"type":"boolean","title":"Include Speakers","default":true},"include_timestamps":{"type":"boolean","title":"Include Timestamps","default":true},"format":{"type":"string","title":"Format","enum":["html"]},"segment_on_silence_longer_than_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Segment On Silence Longer Than S"},"max_segment_duration_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Max Segment Duration S"},"max_segment_chars":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Segment Chars"}},"type":"object","required":["format"],"title":"HtmlExportOptions"},{"properties":{"max_characters_per_line":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Characters Per Line","default":42},"include_speakers":{"type":"boolean","title":"Include Speakers","default":false},"include_timestamps":{"type":"boolean","title":"Include Timestamps","default":true},"format":{"type":"string","title":"Format","enum":["srt"]},"segment_on_silence_longer_than_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Segment On Silence Longer Than S","default":0.8},"max_segment_duration_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Max Segment Duration S","default":4},"max_segment_chars":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Segment Chars","default":84}},"type":"object","required":["format"],"title":"SrtExportOptions"}],"title":"ExportOptions","discriminator":{"propertyName":"format","mapping":{"docx":"#/components/schemas/DocxExportOptions","html":"#/components/schemas/HtmlExportOptions","pdf":"#/components/schemas/PdfExportOptions","segmented_json":"#/components/schemas/SegmentedJsonExportOptions","srt":"#/components/schemas/SrtExportOptions","txt":"#/components/schemas/TxtExportOptions"}}},"type":"array","maxItems":10,"title":"AdditionalFormats"},"webhook_id":{"anyOf":[{"type":"string"},{"type":"string","nullable":true}],"title":"Webhook Id","description":"Optional specific webhook ID to send the transcription result to. Only valid when webhook is set to true. If not provided, transcription will be sent to all configured speech-to-text webhooks."},"temperature":{"anyOf":[{"type":"number","maximum":2,"minimum":0},{"type":"string","nullable":true}],"title":"Temperature","description":"Controls the randomness of the transcription output. Accepts values between 0.0 and 2.0, where higher values result in more diverse and less deterministic results. If omitted, we will use a temperature based on the model you selected which is usually 0."},"seed":{"anyOf":[{"type":"integer","maximum":2147483647,"minimum":0},{"type":"string","nullable":true}],"title":"Seed","description":"If specified, our system will make a best effort to sample deterministically, such that repeated requests with the same seed and parameters should return the same result. Determinism is not guaranteed. Must be an integer between 0 and 2147483647."},"webhook_metadata":{"anyOf":[{"type":"string"},{"type":"object"},{"type":"string","nullable":true}],"title":"Webhook Metadata","description":"Optional metadata to be included in the webhook response. This should be a JSON string representing an object with a maximum depth of 2 levels and maximum size of 16KB. Useful for tracking internal IDs, job references, or other contextual information."},"entity_detection":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"string","nullable":true}],"title":"Entity Detection","description":"Detect entities in the transcript. Can be 'all' to detect all entities, a single entity type or category string, or a list of entity types/categories. Categories include 'pii', 'phi', 'pci', 'other', 'offensive_language'. When enabled, detected entities will be returned in the 'entities' field with their text, type, and character positions."},"keyterms":{"items":{"type":"string"},"type":"array","title":"Keyterms","description":"A list of keyterms to bias the transcription towards.           The keyterms are words or phrases you want the model to recognise more accurately.           The number of keyterms cannot exceed 100.           The length of each keyterm must be less than 50 characters.           Keyterms can contain at most 5 words (after normalisation).           For example [\"hello\", \"world\", \"technical term\"]","default":[]},"enable_logging":{"type":"boolean","default":true,"description":"When set to false, zero retention mode will be used for the request."}},"type":"object","required":["model_id"],"title":"Body_Speech_to_Text_v1_speech_to_text_post","writeOnly":true,"description":"Eleven Labs batch transcription. Docs: https://elevenlabs.io/docs/api-reference/speech-to-text"}}},"RecordingCreateTranscriptArtifactRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"},"writeOnly":true},"diarization":{"allOf":[{"$ref":"#/components/schemas/RecordingCreateTranscriptDiarizationRequest"}],"writeOnly":true},"provider":{"allOf":[{"$ref":"#/components/schemas/RecordingCreateTranscriptArtifactProviderRequest"}],"writeOnly":true}},"required":["provider"]},"RecordingCreateTranscriptDiarizationRequest":{"type":"object","properties":{"use_separate_streams_when_available":{"type":"boolean"}}},"RecordingMinimal":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string","nullable":true},"nullable":true}},"required":["id","metadata"]},"RecordingMinimalRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string","nullable":true},"nullable":true}},"required":["metadata"]},"RecordingShortcuts":{"type":"object","properties":{"video_mixed":{"allOf":[{"$ref":"#/components/schemas/VideoMixedArtifactShortcut"}],"readOnly":true,"nullable":true},"transcript":{"allOf":[{"$ref":"#/components/schemas/TranscriptArtifactShortcut"}],"readOnly":true,"nullable":true},"participant_events":{"allOf":[{"$ref":"#/components/schemas/ParticipantEventsArtifactShortcut"}],"readOnly":true,"nullable":true},"meeting_metadata":{"allOf":[{"$ref":"#/components/schemas/MeetingMetadataArtifactShortcut"}],"readOnly":true,"nullable":true},"audio_mixed":{"allOf":[{"$ref":"#/components/schemas/AudioMixedArtifactShortcut"}],"readOnly":true,"nullable":true}},"required":["audio_mixed","meeting_metadata","participant_events","transcript","video_mixed"]},"RecordingStatus":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/RecordingStatusCodeEnum"},"sub_code":{"type":"string","nullable":true},"updated_at":{"type":"string","format":"date-time"}},"required":["code","sub_code","updated_at"]},"RecordingStatusCodeEnum":{"enum":["processing","paused","done","failed","deleted"],"type":"string","description":"* `processing` - Processing\n* `paused` - Paused\n* `done` - Done\n* `failed` - Failed\n* `deleted` - Deleted"},"RecordingStatusRequest":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/RecordingStatusCodeEnum"},"sub_code":{"type":"string","nullable":true,"minLength":1},"updated_at":{"type":"string","format":"date-time"}},"required":["code","sub_code","updated_at"]},"SendChatMessageInputRequest":{"type":"object","properties":{"to":{"type":"string","minLength":1,"default":"everyone","description":"The person or group that the message will be sent to. On non-Zoom platforms, \"everyone\" is currently the only supported option, meaning the message will be sent to everyone in the meeting."},"message":{"type":"string","minLength":1,"description":"The message that will be sent.","maxLength":4096},"pin":{"type":"boolean","default":false}},"required":["message"]},"SendToEnum":{"enum":["host","everyone","everyone_except_host"],"type":"string","description":"* `host` - host\n* `everyone` - everyone\n* `everyone_except_host` - everyone_except_host"},"SlackTeamIntegration":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"email_address":{"type":"string","format":"email","description":"The email address of the bot user. This is the email address that the customer will invite to their Slack workspace."},"slack_team_domain":{"type":"string","description":"The domain of the Slack workspace that the bot user will be invited to. For instance \"mycompany.slack.com\".","pattern":"^[a-zA-Z0-9-]+\\.slack\\.com$"},"bot_name":{"type":"string","description":"The name of the bot user. This is the name that will be displayed in Slack."},"profile_photo_base64_jpg":{"type":"string","nullable":true,"description":"The profile photo of the bot user, encoded as a base64 string. This is the profile photo that will be displayed in Slack. This must be a 512x512px JPEG image.","maxLength":1835008},"auto_join_public_huddles":{"type":"boolean","description":"Whether the bot user should automatically join huddles occuring in public channels."},"ask_to_join_private_huddles":{"type":"boolean","description":"Whether the bot user should ask to join huddles occuring in private channels."},"ask_to_join_message":{"type":"string","description":"The message that the bot user will send when asking to join a private huddle."},"filter_huddles_by_user_emails":{"type":"array","items":{"type":"string","format":"email"},"nullable":true,"description":"A list of email addresses. If this is set, the bot user will only join huddles where one of the users is a participant of the huddle."},"huddle_bot_config":{"allOf":[{"$ref":"#/components/schemas/HuddleBotConfigSchema"}],"description":"The configuration of the bot to join a huddle."},"status":{"type":"string","readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true}},"required":["ask_to_join_message","ask_to_join_private_huddles","auto_join_public_huddles","bot_name","created_at","email_address","huddle_bot_config","id","slack_team_domain","status","updated_at"]},"SlackTeamIntegrationMinimal":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string","nullable":true}}},"required":["id","metadata"]},"SlackTeamIntegrationMinimalRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string","nullable":true}}},"required":["metadata"]},"SlackTeamIntegrationRequest":{"type":"object","properties":{"email_address":{"type":"string","format":"email","minLength":1,"description":"The email address of the bot user. This is the email address that the customer will invite to their Slack workspace."},"slack_team_domain":{"type":"string","minLength":1,"description":"The domain of the Slack workspace that the bot user will be invited to. For instance \"mycompany.slack.com\".","pattern":"^[a-zA-Z0-9-]+\\.slack\\.com$"},"bot_name":{"type":"string","minLength":1,"description":"The name of the bot user. This is the name that will be displayed in Slack."},"profile_photo_base64_jpg":{"type":"string","nullable":true,"minLength":1,"description":"The profile photo of the bot user, encoded as a base64 string. This is the profile photo that will be displayed in Slack. This must be a 512x512px JPEG image.","maxLength":1835008},"auto_join_public_huddles":{"type":"boolean","description":"Whether the bot user should automatically join huddles occuring in public channels."},"ask_to_join_private_huddles":{"type":"boolean","description":"Whether the bot user should ask to join huddles occuring in private channels."},"ask_to_join_message":{"type":"string","minLength":1,"description":"The message that the bot user will send when asking to join a private huddle."},"filter_huddles_by_user_emails":{"type":"array","items":{"type":"string","format":"email","minLength":1},"nullable":true,"description":"A list of email addresses. If this is set, the bot user will only join huddles where one of the users is a participant of the huddle."},"huddle_bot_config":{"allOf":[{"$ref":"#/components/schemas/HuddleBotConfigSchemaRequest"}],"description":"The configuration of the bot to join a huddle."}},"required":["ask_to_join_message","ask_to_join_private_huddles","auto_join_public_huddles","bot_name","email_address","huddle_bot_config","slack_team_domain"]},"SlackUserOauthToken":{"type":"object","description":"Serializer for Slack user OAuth tokens.","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"slack_team_integration_id":{"type":"string","format":"uuid","readOnly":true},"token":{"type":"string","description":"The OAuth token for the Slack user. Only a few characters are shown in responses."},"slack_user_id":{"type":"string","readOnly":true,"description":"The Slack user ID that this token belongs to."},"slack_team_id":{"type":"string","readOnly":true,"description":"The Slack team ID that this token belongs to."},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true}},"required":["created_at","id","slack_team_id","slack_team_integration_id","slack_user_id","token","updated_at"]},"SlackUserOauthTokenRequest":{"type":"object","description":"Serializer for Slack user OAuth tokens.","properties":{"token":{"type":"string","minLength":1,"description":"The OAuth token for the Slack user. Only a few characters are shown in responses."}},"required":["token"]},"StartRecordingOnEnum":{"enum":["call_join","participant_join","participant_speak"],"type":"string","description":"* `call_join` - call_join\n* `participant_join` - participant_join\n* `participant_speak` - participant_speak"},"TeamsLiveMeetingInviteMeetingLink":{"type":"object","properties":{"platform":{"$ref":"#/components/schemas/TeamsLiveMeetingInviteMeetingLinkPlatformEnum"},"meeting_id":{"type":"string"},"meeting_password":{"type":"string","nullable":true}},"required":["meeting_id","platform"]},"TeamsLiveMeetingInviteMeetingLinkPlatformEnum":{"enum":["microsoft_teams_live"],"type":"string","description":"* `microsoft_teams_live` - microsoft_teams_live"},"TeamsMeetingInvite":{"type":"object","properties":{"meeting_id":{"type":"string","nullable":true},"meeting_password":{"type":"string","nullable":true},"organizer_id":{"type":"string","nullable":true},"tenant_id":{"type":"string","nullable":true},"message_id":{"type":"string","nullable":true},"thread_id":{"type":"string","nullable":true},"business_meeting_id":{"type":"string","nullable":true},"business_meeting_password":{"type":"string","nullable":true}}},"TeamsMeetingInviteMeetingLink":{"type":"object","properties":{"platform":{"$ref":"#/components/schemas/TeamsMeetingInviteMeetingLinkPlatformEnum"},"meeting_id":{"type":"string","nullable":true},"meeting_password":{"type":"string","nullable":true},"organizer_id":{"type":"string","nullable":true},"tenant_id":{"type":"string","nullable":true},"message_id":{"type":"string","nullable":true},"thread_id":{"type":"string","nullable":true},"business_meeting_id":{"type":"string","nullable":true},"business_meeting_password":{"type":"string","nullable":true}},"required":["platform"]},"TeamsMeetingInviteMeetingLinkPlatformEnum":{"enum":["microsoft_teams"],"type":"string","description":"* `microsoft_teams` - microsoft_teams"},"TranscriptArtifact":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"recording":{"allOf":[{"$ref":"#/components/schemas/RecordingMinimal"}],"readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/ArtifactStatus"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"data":{"allOf":[{"$ref":"#/components/schemas/TranscriptArtifactData"}],"readOnly":true},"diarization":{"allOf":[{"$ref":"#/components/schemas/TranscriptArtifactDiarization"}],"readOnly":true,"nullable":true},"provider":{"allOf":[{"$ref":"#/components/schemas/TranscriptArtifactProvider"}],"readOnly":true}},"required":["created_at","data","diarization","id","metadata","provider","recording","status"]},"TranscriptArtifactData":{"type":"object","properties":{"download_url":{"type":"string","format":"uri","readOnly":true,"nullable":true,"description":"Download transcript for the recording. **[See response format here](https://docs.recall.ai/docs/download-schemas#json-transcript-download-url)**"},"provider_data_download_url":{"type":"string","format":"uri","readOnly":true,"nullable":true,"description":"Download raw transcription data received from the provider for the recording. **[See response format here](https://docs.recall.ai/docs/download-schemas#json-transcript-provider-data-download-url)**"}},"required":["download_url","provider_data_download_url"]},"TranscriptArtifactDiarization":{"type":"object","properties":{"use_separate_streams_when_available":{"type":"boolean","readOnly":true}},"required":["use_separate_streams_when_available"]},"TranscriptArtifactProvider":{"type":"object","properties":{"assembly_ai_async":{"properties":{"audio_end_at":{"x-label":"Audio end at","description":"The point in time, in milliseconds, to stop transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer"},"audio_start_from":{"x-label":"Audio start from","description":"The point in time, in milliseconds, to begin transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer"},"auto_chapters":{"x-label":"Auto chapters","description":"Enable [Auto Chapters](https://www.assemblyai.com/docs/speech-understanding/auto-chapters), can be true or false","type":"boolean","default":false},"auto_highlights":{"x-label":"Key phrases","description":"Enable [Key Phrases](https://www.assemblyai.com/docs/speech-understanding/key-phrases), either true or false","type":"boolean","default":false},"content_safety":{"x-label":"Content Moderation","description":"Enable [Content Moderation](https://www.assemblyai.com/docs/content-moderation), can be true or false","type":"boolean","default":false},"content_safety_confidence":{"x-label":"Content Moderation confidence","description":"The confidence threshold for the [Content Moderation](https://www.assemblyai.com/docs/content-moderation) model. Values must be between 25 and 100.","type":"integer","default":50,"minimum":25,"maximum":100},"custom_spelling":{"x-label":"Custom spellings","description":"Customize how words are spelled and formatted using to and from values. See [Custom Spelling](https://www.assemblyai.com/docs/pre-recorded-audio/custom-spelling) for more details.","type":"array","items":{"x-label":"Custom spelling","description":"Object containing words or phrases to replace, and the word or phrase to replace with","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"from":{"x-label":"From","description":"Words or phrases to replace","type":"array","items":{"x-label":"Word or phrase","description":"Word or phrase to replace","type":"string"}},"to":{"x-label":"To","description":"Word to replace with","type":"string"}},"required":["from","to"],"example":{"from":["dicarlo"],"to":"Decarlo"}}},"disfluencies":{"x-label":"Disfluencies","description":"Transcribe [Filler Words](https://www.assemblyai.com/docs/pre-recorded-audio/filler-words), like \"umm\", in your media file; can be true or false","type":"boolean","default":false},"entity_detection":{"x-label":"Entity Detection","description":"Enable [Entity Detection](https://www.assemblyai.com/docs/speech-understanding/entity-detection), can be true or false","type":"boolean","default":false},"filter_profanity":{"x-label":"Filter profanity","description":"Filter profanity from the transcribed text, can be true or false. See [Profanity Filtering](https://www.assemblyai.com/docs/profanity-filtering) for more details.","type":"boolean","default":false},"format_text":{"x-label":"Format text","description":"Enable [Text Formatting](https://www.assemblyai.com/docs/pre-recorded-audio), can be true or false","type":"boolean","default":true},"iab_categories":{"x-label":"Topic Detection","description":"Enable [Topic Detection](https://www.assemblyai.com/docs/speech-understanding/topic-detection), can be true or false","type":"boolean","default":false},"keyterms_prompt":{"x-label":"Keyterms prompt","description":"Improve accuracy with up to 200 (for Universal-2) or 1000 (for Universal-3-Pro) domain-specific words or phrases (maximum 6 words per phrase). See [Keyterms Prompting](https://www.assemblyai.com/docs/pre-recorded-audio/keyterms-prompting) for more details.\n","type":"array","items":{"x-label":"Keyterm","type":"string"}},"language_code":{"x-label":"Language code","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","oneOf":[{"anyOf":[{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"}}},{"type":"string"}]},{"type":"string","nullable":true}],"default":"en_us","x-ts-type":"LiteralUnion<TranscriptLanguageCode, string> | null","x-go-type":"TranscriptLanguageCode"},"language_codes":{"description":"The language codes of your audio file. Used for [Code switching](/docs/speech-to-text/pre-recorded-audio/code-switching)\nOne of the values specified must be `en`.\n","type":"array","items":{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"}}},"nullable":true},"language_confidence_threshold":{"x-label":"Language confidence threshold","description":"The confidence threshold for the automatically detected language.\nAn error will be returned if the language confidence is below this threshold.\nDefaults to 0. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0},"language_detection":{"x-label":"Language detection","description":"Enable [Automatic language detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection), either true or false.","type":"boolean","default":false},"language_detection_options":{"x-label":"Specify options for Automatic Language Detection.","description":"Specify options for [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection).","type":"object","additionalProperties":false,"properties":{"expected_languages":{"x-label":"Expected languages","description":"List of languages expected in the audio file. Defaults to `[\"all\"]` when unspecified. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.","type":"array","items":{"x-label":"language","type":"string"}},"fallback_language":{"x-label":"Fallback language","description":"If the detected language of the audio file is not in the list of expected languages, the `fallback_language` is used. Specify `[\"auto\"]` to let our model choose the fallback language from `expected_languages` with the highest confidence score. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"string","default":"auto"},"code_switching":{"x-label":"Code switching","description":"Whether [code switching](/docs/speech-to-text/pre-recorded-audio/code-switching) should be detected.\n","type":"boolean","default":false},"code_switching_confidence_threshold":{"x-label":"Code switching confidence threshold","description":"The confidence threshold for [code switching](/docs/speech-to-text/pre-recorded-audio/code-switching) detection. If the code switching confidence is below this threshold, the transcript will be processed in the language with the highest `language_detection_confidence` score.\n","type":"number","minimum":0,"maximum":1,"default":0.3}}},"multichannel":{"x-label":"Multichannel","description":"Enable [Multichannel](https://www.assemblyai.com/docs/pre-recorded-audio/multichannel) transcription, can be true or false.","type":"boolean","default":false},"prompt":{"x-label":"Prompt","description":"Provide natural language prompting of up to 1,500 words of contextual information to the model. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for best practices.\n\nNote: This parameter is only supported for the Universal-3-Pro model.\n","type":"string"},"punctuate":{"x-label":"Punctuate","description":"Enable [Automatic Punctuation](https://www.assemblyai.com/docs/pre-recorded-audio), can be true or false","type":"boolean","default":true},"redact_pii":{"x-label":"Redact PII","description":"Redact PII from the transcribed text using the Redact PII model, can be true or false. See [PII Redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"boolean","default":false},"redact_pii_audio":{"x-label":"Redact PII audio","description":"Generate a copy of the original media file with spoken PII \"beeped\" out, can be true or false. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","type":"boolean","default":false},"redact_pii_audio_options":{"x-label":"Specify options for PII redacted audio files.","description":"Specify options for [PII redacted audio](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) files.","type":"object","additionalProperties":false,"properties":{"return_redacted_no_speech_audio":{"x-label":"Return redacted no speech audio","description":"By default, audio redaction provides redacted audio URLs only when speech is detected. However, if your use-case specifically requires redacted audio files even for silent audio files without any dialogue, you can opt to receive these URLs by setting this parameter to `true`.","type":"boolean","default":false}}},"redact_pii_audio_quality":{"x-label":"Redact PII audio quality","type":"string","description":"Controls the filetype of the audio created by redact_pii_audio. Currently supports mp3 (default) and wav. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","x-fern-sdk-group-name":"transcripts","enum":["mp3","wav"],"x-fern-enum":{"mp3":{"description":"MP3 audio format is lower quality and lower size than WAV.","casing":{"camel":"mp3","snake":"mp3","pascal":"Mp3","screamingSnake":"MP3"}},"wav":{"description":"WAV audio format is the highest quality (no compression) and larger size than MP3."}},"x-aai-enum":{"mp3":{"label":"MP3"},"wav":{"label":"WAV"}},"example":"mp3"},"redact_pii_policies":{"x-label":"Redact PII policies","description":"The list of PII Redaction policies to enable. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"array","items":{"x-label":"PII policy","description":"The type of PII to redact","x-fern-sdk-group-name":"transcripts","type":"string","enum":["account_number","banking_information","blood_type","credit_card_cvv","credit_card_expiration","credit_card_number","date","date_interval","date_of_birth","drivers_license","drug","duration","email_address","event","filename","gender_sexuality","healthcare_number","injury","ip_address","language","location","marital_status","medical_condition","medical_process","money_amount","nationality","number_sequence","occupation","organization","passport_number","password","person_age","person_name","phone_number","physical_attribute","political_affiliation","religion","statistics","time","url","us_social_security_number","username","vehicle_id","zodiac_sign"],"x-fern-enum":{"account_number":{"description":"Customer account or membership identification number (e.g., Policy No. 10042992, Member ID: HZ-5235-001)"},"banking_information":{"description":"Banking information, including account and routing numbers"},"blood_type":{"description":"Blood type (e.g., O-, AB positive)"},"credit_card_cvv":{"description":"Credit card verification code (e.g., CVV: 080)"},"credit_card_expiration":{"description":"Expiration date of a credit card"},"credit_card_number":{"description":"Credit card number"},"date":{"description":"Specific calendar date (e.g., December 18)"},"date_interval":{"description":"Broader time periods, including date ranges, months, seasons, years, and decades (e.g., 2020-2021, 5-9 May, January 1984)"},"date_of_birth":{"description":"Date of birth (e.g., Date of Birth: March 7,1961)"},"drivers_license":{"description":"Driver's license number. (e.g., DL# 356933-540)"},"drug":{"description":"Medications, vitamins, or supplements (e.g., Advil, Acetaminophen, Panadol)"},"duration":{"description":"Periods of time, specified as a number and a unit of time (e.g., 8 months, 2 years)"},"email_address":{"description":"Email address (e.g., support@assemblyai.com)"},"event":{"description":"Name of an event or holiday (e.g., Olympics, Yom Kippur)"},"filename":{"description":"Names of computer files, including the extension or filepath (e.g., Taxes/2012/brad-tax-returns.pdf)"},"gender_sexuality":{"description":"Terms indicating gender identity or sexual orientation, including slang terms (e.g., female, bisexual, trans)"},"healthcare_number":{"description":"Healthcare numbers and health plan beneficiary numbers (e.g., Policy No.: 5584-486-674-YM)"},"injury":{"description":"Bodily injury (e.g., I broke my arm, I have a sprained wrist)"},"ip_address":{"description":"Internet IP address, including IPv4 and IPv6 formats (e.g., 192.168.0.1)"},"language":{"description":"Name of a natural language (e.g., Spanish, French)"},"location":{"description":"Any Location reference including mailing address, postal code, city, state, province, country, or coordinates. (e.g., Lake Victoria, 145 Windsor St., 90210)"},"marital_status":{"description":"Terms indicating marital status (e.g., Single, common-law, ex-wife, married)"},"medical_condition":{"description":"Name of a medical condition, disease, syndrome, deficit, or disorder (e.g., chronic fatigue syndrome, arrhythmia, depression)"},"medical_process":{"description":"Medical process, including treatments, procedures, and tests (e.g., heart surgery, CT scan)"},"money_amount":{"description":"Name and/or amount of currency (e.g., 15 pesos, $94.50)"},"nationality":{"description":"Terms indicating nationality, ethnicity, or race (e.g., American, Asian, Caucasian)"},"number_sequence":{"description":"Numerical PII (including alphanumeric strings) that doesn't fall under other categories"},"occupation":{"description":"Job title or profession (e.g., professor, actors, engineer, CPA)"},"organization":{"description":"Name of an organization (e.g., CNN, McDonalds, University of Alaska, Northwest General Hospital)"},"passport_number":{"description":"Passport numbers, issued by any country (e.g., PA4568332, NU3C6L86S12)"},"password":{"description":"Account passwords, PINs, access keys, or verification answers (e.g., 27%alfalfa, temp1234, My mother's maiden name is Smith)"},"person_age":{"description":"Number associated with an age (e.g., 27, 75)"},"person_name":{"description":"Name of a person (e.g., Bob, Doug Jones, Dr. Kay Martinez, MD)"},"phone_number":{"description":"Telephone or fax number"},"physical_attribute":{"description":"Distinctive bodily attributes, including terms indicating race (e.g., I'm 190cm tall, He belongs to the Black students' association)"},"political_affiliation":{"description":"Terms referring to a political party, movement, or ideology (e.g., Republican, Liberal)"},"religion":{"description":"Terms indicating religious affiliation (e.g., Hindu, Catholic)"},"statistics":{"description":"Medical statistics (e.g., 18%, 18 percent)"},"time":{"description":"Expressions indicating clock times (e.g., 19:37:28, 10pm EST)"},"url":{"description":"Internet addresses (e.g., https://www.assemblyai.com/)"},"us_social_security_number":{"description":"Social Security Number or equivalent"},"username":{"description":"Usernames, login names, or handles (e.g., @AssemblyAI)"},"vehicle_id":{"description":"Vehicle identification numbers (VINs), vehicle serial numbers, and license plate numbers (e.g., 5FNRL38918B111818, BIF7547)"},"zodiac_sign":{"description":"Names of Zodiac signs (e.g., Aries, Taurus)"}},"x-aai-enum":{"account_number":{"label":"Account number"},"banking_information":{"label":"Banking information"},"blood_type":{"label":"Blood type"},"credit_card_cvv":{"label":"Credit card CVV"},"credit_card_expiration":{"label":"Credit card expiration"},"credit_card_number":{"label":"Credit card number"},"date":{"label":"Date"},"date_interval":{"label":"Date interval"},"date_of_birth":{"label":"Date of birth"},"drivers_license":{"label":"Driver's license"},"drug":{"label":"Drug"},"duration":{"label":"Duration"},"email_address":{"label":"Email address"},"event":{"label":"Event"},"filename":{"label":"Filename"},"gender_sexuality":{"label":"Gender sexuality"},"healthcare_number":{"label":"Healthcare number"},"injury":{"label":"Injury"},"ip_address":{"label":"IP address"},"language":{"label":"Language"},"location":{"label":"Location"},"marital_status":{"label":"Marital status"},"medical_condition":{"label":"Medical condition"},"medical_process":{"label":"Medical process"},"money_amount":{"label":"Money amount"},"nationality":{"label":"Nationality"},"number_sequence":{"label":"Number sequence"},"occupation":{"label":"Occupation"},"organization":{"label":"Organization"},"passport_number":{"label":"Passport number"},"password":{"label":"Password"},"person_age":{"label":"Person age"},"person_name":{"label":"Person name"},"phone_number":{"label":"Phone number"},"physical_attribute":{"label":"Physical attribute"},"political_affiliation":{"label":"Political affiliation"},"religion":{"label":"Religion"},"statistics":{"label":"Statistics"},"time":{"label":"Time"},"url":{"label":"URL"},"us_social_security_number":{"label":"US Social Security Number"},"username":{"label":"Username"},"vehicle_id":{"label":"Vehicle ID"},"zodiac_sign":{"label":"Zodiac sign"}}}},"redact_pii_sub":{"x-label":"Redact PII substitution","description":"The replacement logic for detected PII, can be `entity_type` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","oneOf":[{"x-label":"Redact PII substitution","type":"string","x-fern-sdk-group-name":"transcripts","description":"The replacement logic for detected PII, can be `entity_name` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","enum":["entity_name","hash"],"x-aai-enum":{"entity_name":{"label":"Entity name"},"hash":{"label":"Hash"}}},{"type":"string","nullable":true}],"default":"hash"},"sentiment_analysis":{"x-label":"Sentiment Analysis","description":"Enable [Sentiment Analysis](https://www.assemblyai.com/docs/speech-understanding/sentiment-analysis), can be true or false","type":"boolean","default":false},"speaker_labels":{"x-label":"Speaker labels","description":"Enable [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization), can be true or false","type":"boolean","default":false},"speaker_options":{"x-label":"Specify options for speaker diarization.","description":"Specify options for [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers). Use this to set a range of possible speakers.","type":"object","additionalProperties":false,"properties":{"min_speakers_expected":{"x-label":"Minimum speakers expected","description":"The minimum number of speakers expected in the audio file. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers) for more details.","type":"integer","default":1},"max_speakers_expected":{"x-label":"Maximum speakers expected","description":"<Warning>Setting this parameter too high may hurt model accuracy</Warning>\nThe maximum number of speakers expected in the audio file. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers) for more details.\n","type":"integer","default":10}}},"speakers_expected":{"x-label":"Speakers expected","description":"Tells the speaker label model how many speakers it should attempt to identify. See [Set number of speakers expected](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-number-of-speakers-expected) for more details.","type":"integer","default":null,"nullable":true},"speech_models":{"x-label":"Speech models","description":"List multiple speech models in priority order, allowing our system to automatically route your audio to the best available option. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models and routing behavior.\n","type":"array","items":{"x-label":"Speech model","type":"string","description":"The speech model to use for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","x-fern-sdk-group-name":"transcripts"}},"speech_threshold":{"x-label":"Speech threshold","description":"Reject audio files that contain less than this fraction of speech.\nValid values are in the range [0, 1] inclusive. See [Speech Threshold](https://www.assemblyai.com/docs/speech-threshold) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0,"nullable":true},"speech_understanding":{"x-label":"Speech Understanding","description":"Enable speech understanding tasks like [Translation](https://www.assemblyai.com/docs/speech-understanding/translation), [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification), and [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting). See the task-specific docs for available options and configuration.\n","type":"object","properties":{"request":{"oneOf":[{"x-label":"Translation request body","description":"Request body for [Translation](https://www.assemblyai.com/docs/speech-understanding/translation).","type":"object","properties":{"translation":{"type":"object","properties":{"target_languages":{"type":"array","items":{"type":"string"},"description":"List of target language codes (e.g., `[\"es\", \"de\"]`). See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for supported languages."},"formal":{"type":"boolean","description":"Use formal language style. See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for more details.","default":true},"match_original_utterance":{"type":"boolean","description":"When enabled with Speaker Labels, returns translated text in the utterances array. Each utterance will include a `translated_texts` key containing translations for each target language.","default":false}},"required":["target_languages"]}},"required":["translation"]},{"type":"object","description":"Request body for [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification).","properties":{"speaker_identification":{"type":"object","properties":{"speaker_type":{"type":"string","enum":["role","name"],"description":"Type of speaker identification. See [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification) for details on each type."},"known_values":{"type":"array","items":{"type":"string"},"description":"Required if speaker_type is \"role\". Each value must be 35 characters or less."},"speakers":{"type":"array","description":"An array of speaker objects with metadata to improve identification accuracy. Each object should include a `role` or `name` (depending on `speaker_type`) and an optional `description` to help the model identify the speaker. You can also include any additional custom properties (e.g., `company`, `title`) to provide more context. Use this as an alternative to `known_values` when you want to provide additional context about each speaker.","items":{"type":"object","properties":{"role":{"type":"string","description":"The role of the speaker. Required when `speaker_type` is \"role\"."},"name":{"type":"string","description":"The name of the speaker. Required when `speaker_type` is \"name\"."},"description":{"type":"string","description":"A description of the speaker to help the model identify them based on conversational context."}},"additionalProperties":true}}},"required":["speaker_type"]}},"required":["speaker_identification"]},{"type":"object","description":"Request body for [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting).","properties":{"custom_formatting":{"type":"object","properties":{"date":{"type":"string","description":"Date format pattern (e.g., `\"mm/dd/yyyy\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."},"phone_number":{"type":"string","description":"Phone number format pattern (e.g., `\"(xxx)xxx-xxxx\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."},"email":{"type":"string","description":"Email format pattern (e.g., `\"username@domain.com\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."}}}},"required":["custom_formatting"]}]}},"required":["request"]},"summarization":{"x-label":"Enable Summarization","description":"Enable [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization), can be true or false","type":"boolean","default":false},"summary_model":{"type":"string","x-label":"Summary model","description":"The model to summarize the transcript","x-fern-sdk-group-name":"transcripts","enum":["informative","conversational","catchy"],"x-aai-enum":{"informative":{"label":"Informative"},"conversational":{"label":"Conversational"},"catchy":{"label":"Catchy"}}},"summary_type":{"type":"string","x-label":"Summary type","description":"The type of summary","x-fern-sdk-group-name":"transcripts","enum":["bullets","bullets_verbose","gist","headline","paragraph"],"x-aai-enum":{"bullets":{"label":"Bullets"},"bullets_verbose":{"label":"Bullets verbose"},"gist":{"label":"Gist"},"headline":{"label":"Headline"},"paragraph":{"label":"Paragraph"}}},"temperature":{"x-label":"Temperature","description":"Control the amount of randomness injected into the model's response. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for more details.\n\nNote: This parameter can only be used with the Universal-3-Pro model.\n","type":"number","minimum":0,"maximum":1,"default":0},"webhook_auth_header_name":{"x-label":"Webhook auth header name","description":"The header name to be sent with the transcript completed or failed [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests","type":"string","default":null,"nullable":true},"webhook_auth_header_value":{"x-label":"Webhook auth header value","description":"The header value to send back with the transcript completed or failed [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests for added security","type":"string","default":null,"nullable":true},"webhook_url":{"x-label":"Webhook URL","description":"The URL to which we send [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests.\n","type":"string","format":"url"},"custom_topics":{"x-label":"Enable custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"boolean","default":false,"deprecated":true},"speech_model":{"x-label":"Speech model","description":"This parameter has been replaced with the `speech_models` parameter, learn more about the `speech_models` parameter [here](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model).\n","oneOf":[{"x-label":"Speech model","type":"string","description":"The speech model to use for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","x-fern-sdk-group-name":"transcripts"},{"type":"string","nullable":true}],"deprecated":true},"topics":{"x-label":"Custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"array","items":{"x-label":"Topic","type":"string"},"deprecated":true}},"type":"object","additionalProperties":false,"x-label":"Optional transcript parameters","description":"The parameters for creating a transcript","x-fern-sdk-group-name":"transcripts","example":{"speech_model":null,"language_code":"en_us","language_detection":true,"language_confidence_threshold":0.7,"punctuate":true,"format_text":true,"multichannel":true,"webhook_url":"https://your-webhook-url.tld/path","webhook_auth_header_name":"webhook-secret","webhook_auth_header_value":"webhook-secret-value","auto_highlights":true,"audio_start_from":10,"audio_end_at":280,"filter_profanity":true,"redact_pii":true,"redact_pii_audio":true,"redact_pii_audio_quality":"mp3","redact_pii_policies":["us_social_security_number","credit_card_number"],"redact_pii_sub":"hash","speaker_labels":true,"speakers_expected":2,"content_safety":true,"iab_categories":true,"custom_spelling":[],"disfluencies":false,"sentiment_analysis":true,"auto_chapters":true,"entity_detection":true,"speech_threshold":0.5,"summarization":true,"summary_model":"informative","summary_type":"bullets","custom_topics":true,"topics":[],"speech_understanding":{"request":{"translation":{"target_languages":["es","de"],"formal":true,"match_original_utterance":true}}}},"readOnly":true,"nullable":true},"deepgram_async":{"type":"object","properties":{"callback":{"type":"string"},"callback_method":{"default":"POST","enum":["POST","PUT"]},"custom_topic":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"},"maxItems":100}]},"custom_topic_mode":{"default":"extended","type":"string","enum":["extended","strict"]},"custom_intent":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string","maxItems":100}}]},"custom_intent_mode":{"default":"extended","type":"string","enum":["extended","strict"]},"detect_entities":{"default":false,"type":"boolean"},"detect_language":{"oneOf":[{"type":"boolean","default":false},{"type":"array","items":{"type":"string"}}]},"diarize":{"default":false,"type":"boolean"},"dictation":{"default":false,"type":"boolean"},"encoding":{"type":"string","enum":["linear16","flac","mulaw","amr-nb","amr-wb","opus","speex","g729"]},"extra":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"filler_words":{"default":false,"type":"boolean"},"intents":{"default":false,"type":"boolean"},"keyterm":{"type":"array","items":{"type":"string"}},"keywords":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"language":{"type":"string","default":"en","enum":["bg","ca","zh","zh-CN","zh-TW","zh-HK","zh-Hans","zh-Hant","cs","da","da-DK","nl","nl-BE","en","en-US","en-AU","en-GB","en-NZ","en-IN","et","fi","fr","fr-CA","de","de-CH","el","hi","hi-Latn","hu","id","it","ja","ko","ko-KR","lv","lt","ms","multi","no","pl","pt","pt-BR","pt-PT","ro","ru","sk","es","es-419","es-LATAM","sv","sv-SE","taq","th","th-TH","tr","uk","vi"]},"measurements":{"default":false,"type":"boolean"},"mip_opt_out":{"default":false,"type":"boolean"},"model":{"default":"base-general","anyOf":[{"type":"string","description":"Our public models available to all accounts","enum":["nova-3","nova-3-general","nova-3-medical","nova-2","nova-2-general","nova-2-meeting","nova-2-finance","nova-2-conversationalai","nova-2-voicemail","nova-2-video","nova-2-medical","nova-2-drivethru","nova-2-automotive","nova","nova-general","nova-phonecall","nova-medical","enhanced","enhanced-general","enhanced-meeting","enhanced-phonecall","enhanced-finance","base","meeting","phonecall","finance","conversationalai","voicemail","video"]},{"type":"string","description":"Custom string if you've had a model trained by Deepgram"}],"example":"nova-3"},"multichannel":{"default":false,"type":"boolean"},"numerals":{"default":false,"type":"boolean"},"paragraphs":{"default":false,"type":"boolean"},"profanity_filter":{"default":false,"type":"boolean"},"punctuate":{"default":false,"type":"boolean"},"redact":{"default":false,"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string","enum":["pci","pii","numbers"]},"maxItems":100}]},"replace":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"search":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"sentiment":{"default":false,"type":"boolean"},"smart_format":{"default":false,"type":"boolean"},"summarize":{"type":"string","enum":["v1","v2","true","false"]},"tag":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"topics":{"default":false,"type":"boolean"},"utterances":{"default":false,"type":"boolean"},"utt_split":{"default":0.8,"type":"number"},"version":{"default":"latest","oneOf":[{"type":"string","description":"Use the latest version of a model","enum":["latest"]},{"type":"string","description":"Use a previous version of a model"}]}},"readOnly":true,"nullable":true},"gladia_v2_async":{"type":"object","properties":{"context_prompt":{"type":"string","description":"**[Deprecated]** Context to feed the transcription model with for possible better accuracy","deprecated":true},"custom_vocabulary":{"type":"boolean","description":"**[Beta]** Can be either boolean to enable custom_vocabulary for this audio or an array with specific vocabulary list to feed the transcription model with","default":false},"custom_vocabulary_config":{"properties":{"vocabulary":{"description":"Specific vocabulary list to feed the transcription model with. Each item can be a string or an object with the following properties: value, intensity, pronunciations, language.","example":["Westeros",{"value":"Stark"},{"value":"Night's Watch","pronunciations":["Nightz Watch"],"intensity":0.4,"language":"en"}],"type":"array","items":{"oneOf":[{"type":"object","properties":{"value":{"type":"string","description":"The text used to replace in the transcription.","example":"Gladia"},"intensity":{"type":"number","description":"The global intensity of the feature.","example":0.5,"minimum":0,"maximum":1},"pronunciations":{"description":"The pronunciations used in the transcription.","type":"array","items":{"type":"string"}},"language":{"type":"string","description":"Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.","example":"en"}},"required":["value"]},{"type":"string"}]}},"default_intensity":{"type":"number","description":"Default intensity for the custom vocabulary","example":0.5,"minimum":0,"maximum":1}},"required":["vocabulary"],"type":"object","description":"**[Beta]** Custom vocabulary configuration, if `custom_vocabulary` is enabled"},"detect_language":{"type":"boolean","description":"**[Deprecated]** Use `language_config` instead. Detect the language from the given audio","default":true,"deprecated":true},"enable_code_switching":{"type":"boolean","description":"**[Deprecated]** Use `language_config` instead.Detect multiple languages in the given audio","default":false,"deprecated":true},"code_switching_config":{"properties":{"languages":{"type":"array","description":"Specify the languages you want to use when detecting multiple languages","default":[],"items":{"type":"string","enum":["af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","ca","zh","hr","cs","da","nl","en","et","fo","fi","fr","gl","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","id","it","ja","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","mymr","ne","no","nn","oc","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","jp"]}}},"type":"object","description":"**[Deprecated]** Use `language_config` instead. Specify the configuration for code switching","deprecated":true},"language":{"type":"string","description":"**[Deprecated]** Use `language_config` instead. Set the spoken language for the given audio (ISO 639 standard)","deprecated":true,"enum":["af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","ca","zh","hr","cs","da","nl","en","et","fo","fi","fr","gl","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","id","it","ja","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","mymr","ne","no","nn","oc","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","jp"]},"callback_url":{"type":"string","description":"**[Deprecated]** Use `callback`/`callback_config` instead. Callback URL we will do a `POST` request to with the result of the transcription","example":"http://callback.example","format":"uri","deprecated":true},"callback":{"type":"boolean","description":"Enable callback for this transcription. If true, the `callback_config` property will be used to customize the callback behaviour","default":false},"callback_config":{"properties":{"url":{"type":"string","description":"The URL to be called with the result of the transcription","example":"http://callback.example","format":"uri"},"method":{"type":"string","description":"The HTTP method to be used. Allowed values are `POST` or `PUT` (default: `POST`)","default":"POST","enum":["POST","PUT"]}},"required":["url"],"type":"object","description":"Customize the callback behaviour (url and http method)"},"subtitles":{"type":"boolean","description":"Enable subtitles generation for this transcription","default":false},"subtitles_config":{"properties":{"formats":{"type":"array","minItems":1,"example":["srt"],"items":{"type":"string","description":"Subtitles formats you want your transcription to be formatted to","enum":["srt","vtt"]}},"minimum_duration":{"type":"number","description":"Minimum duration of a subtitle in seconds","minimum":0},"maximum_duration":{"type":"number","description":"Maximum duration of a subtitle in seconds","minimum":1,"maximum":30},"maximum_characters_per_row":{"type":"integer","description":"Maximum number of characters per row in a subtitle","minimum":1},"maximum_rows_per_caption":{"type":"integer","description":"Maximum number of rows per caption","minimum":1,"maximum":5},"style":{"type":"string","description":"Style of the subtitles. Compliance mode refers to : https://loc.gov/preservation/digital/formats//fdd/fdd000569.shtml#:~:text=SRT%20files%20are%20basic%20text,alongside%2C%20example%3A%20%22MyVideo123 ","default":"default","enum":["default","compliance"]}},"type":"object","description":"Configuration for subtitles generation if `subtitles` is enabled"},"diarization":{"type":"boolean","description":"Enable speaker recognition (diarization) for this audio","default":false},"diarization_config":{"properties":{"number_of_speakers":{"type":"integer","description":"Exact number of speakers in the audio","example":3,"minimum":1},"min_speakers":{"type":"integer","description":"Minimum number of speakers in the audio","example":1,"minimum":0},"max_speakers":{"type":"integer","description":"Maximum number of speakers in the audio","example":2,"minimum":0},"enhanced":{"type":"boolean","description":"**[Alpha]** Use enhanced diarization for this audio","default":false}},"type":"object","description":"Speaker recognition configuration, if `diarization` is enabled"},"translation":{"type":"boolean","description":"**[Beta]** Enable translation for this audio","default":false},"translation_config":{"properties":{"target_languages":{"type":"array","example":["en"],"minItems":1,"items":{"type":"string","description":"The target language in `iso639-1` format","enum":["af","sq","am","ar","hy","as","ast","az","ba","eu","be","bn","bs","br","bg","my","ca","ceb","zh","hr","cs","da","nl","en","et","fo","fi","nl","fr","fy","ff","gd","gl","lg","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","ig","ilo","id","ga","it","ja","jp","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mo","mn","mymr","ne","no","nn","oc","or","pa","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","ss","sv","tl","tg","ta","tt","te","th","bo","tn","tr","tk","uk","ur","uz","vi","cy","wo","xh","yi","yo","zu"]}},"model":{"type":"string","description":"Model you want the translation model to use to translate","default":"base","enum":["base","enhanced"]},"match_original_utterances":{"type":"boolean","description":"Align translated utterances with the original ones","default":true},"lipsync":{"type":"boolean","description":"Whether to apply lipsync to the translated transcription. ","default":true},"context_adaptation":{"type":"boolean","description":"Enables or disables context-aware translation features that allow the model to adapt translations based on provided context.","default":true},"context":{"type":"string","description":"Context information to improve translation accuracy"},"informal":{"type":"boolean","description":"Forces the translation to use informal language forms when available in the target language.","default":false}},"required":["target_languages"],"type":"object","description":"**[Beta]** Translation configuration, if `translation` is enabled"},"summarization":{"type":"boolean","description":"**[Beta]** Enable summarization for this audio","default":false},"summarization_config":{"properties":{"type":{"type":"string","description":"The type of summarization to apply","default":"general","enum":["general","bullet_points","concise"]}},"type":"object","description":"**[Beta]** Summarization configuration, if `summarization` is enabled"},"moderation":{"type":"boolean","description":"**[Alpha]** Enable moderation for this audio","default":false},"named_entity_recognition":{"type":"boolean","description":"**[Alpha]** Enable named entity recognition for this audio","default":false},"chapterization":{"type":"boolean","description":"**[Alpha]** Enable chapterization for this audio","default":false},"name_consistency":{"type":"boolean","description":"**[Alpha]** Enable names consistency for this audio","default":false},"custom_spelling":{"type":"boolean","description":"**[Alpha]** Enable custom spelling for this audio","default":false},"custom_spelling_config":{"properties":{"spelling_dictionary":{"type":"object","description":"The list of spelling applied on the audio transcription","example":{"Gettleman":["gettleman"],"SQL":["Sequel"]}}},"required":["spelling_dictionary"],"type":"object","description":"**[Alpha]** Custom spelling configuration, if `custom_spelling` is enabled"},"structured_data_extraction":{"type":"boolean","description":"**[Alpha]** Enable structured data extraction for this audio","default":false},"structured_data_extraction_config":{"properties":{"classes":{"description":"The list of classes to extract from the audio transcription","example":["Persons","Organizations"],"minItems":1,"type":"array","items":{"type":"array","items":{"type":"string"}}}},"required":["classes"],"type":"object","description":"**[Alpha]** Structured data extraction configuration, if `structured_data_extraction` is enabled"},"sentiment_analysis":{"type":"boolean","description":"**[Alpha]** Enable sentiment analysis for this audio","default":false},"audio_to_llm":{"type":"boolean","description":"**[Alpha]** Enable audio to llm processing for this audio","default":false},"audio_to_llm_config":{"properties":{"prompts":{"description":"The list of prompts applied on the audio transcription","example":["Extract the key points from the transcription"],"minItems":1,"type":"array","items":{"type":"array","items":{"type":"string"}}}},"required":["prompts"],"type":"object","description":"**[Alpha]** Audio to llm configuration, if `audio_to_llm` is enabled"},"custom_metadata":{"type":"object","description":"Custom metadata you can attach to this transcription"},"sentences":{"type":"boolean","description":"Enable sentences for this audio","default":false},"display_mode":{"type":"boolean","description":"**[Alpha]** Allows to change the output display_mode for this audio. The output will be reordered, creating new utterances when speakers overlapped","default":false},"punctuation_enhanced":{"type":"boolean","description":"**[Alpha]** Use enhanced punctuation for this audio","default":false},"language_config":{"properties":{"languages":{"type":"array","description":"If one language is set, it will be used for the transcription. Otherwise, language will be auto-detected by the model.","default":[],"items":{"type":"string","enum":["af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","ca","zh","hr","cs","da","nl","en","et","fo","fi","fr","gl","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","id","it","ja","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","mymr","ne","no","nn","oc","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","jp"]}},"code_switching":{"type":"boolean","description":"If true, language will be auto-detected on each utterance. Otherwise, language will be auto-detected on first utterance and then used for the rest of the transcription. If one language is set, this option will be ignored.","default":false}},"type":"object","description":"Specify the language configuration"}},"readOnly":true,"nullable":true},"rev_async":{"type":"object","properties":{"metadata":{"maxLength":512,"minLength":0,"type":"string","description":"Optional metadata for the job","nullable":true},"delete_after":{"type":"string","description":"Optional setting for the number of Seconds after job completion\r\nwhen the job should be auto-deleted","format":"date-span","nullable":true},"language":{"type":"string","description":"Optional language setting for foreign languages","nullable":true},"skip_diarization":{"type":"boolean","description":"Optional setting for turning on/off diarization.\r\nIf not set, we will assume the value is false.","nullable":true},"skip_postprocessing":{"type":"boolean","description":"Optional setting for turning on/off postprocessing.\r\nIf not set, we will assume the value is false.","nullable":true},"custom_vocabularies":{"maxItems":50,"type":"array","items":{"required":["phrases"],"type":"object","properties":{"phrases":{"maxItems":20000,"minItems":1,"type":"array","items":{"type":"string"}}},"additionalProperties":false},"description":"Optional setting for passing in custom vocabularies.","nullable":true},"custom_vocabulary_id":{"type":"string","description":"The id of the prebuilt custom vocabulary job","nullable":true},"strict_custom_vocabulary":{"type":"boolean","description":"If true, only exact phrases submitted in the Rev.Ai.Api.Models.SubmitJobOptions.CustomVocabularies option will be used as custom vocabulary,\r\ni.e. phrases will not be split into individual words for processing.\r\nDefaults to true if Rev.Ai.Api.Models.SubmitJobOptions.CustomVocabularies is set.","nullable":true},"skip_punctuation":{"type":"boolean","description":"Optional setting for disabling punctuation.\r\nIf unset, the value is assumed to be false.","nullable":true},"remove_disfluencies":{"type":"boolean","description":"Optional setting for removing disfluencies\r\nIf unset the value is assumed to be false","nullable":true},"remove_atmospherics":{"type":"boolean","description":"Optional setting for removing atmospherics\r\nIf unset the value is assumed to be false","nullable":true},"filter_profanity":{"type":"boolean","description":"Optional setting for removing profanities\r\nIf unset the value is assumed to be false","nullable":true},"add_data_labels":{"type":"boolean","description":"Optional setting for adding data classification labels\r\nIf unset the value is assumed to be false","nullable":true},"enable_redaction":{"type":"boolean","description":"Optional setting for redacting certain data labels\r\nIf unset the value is assumed to be false","nullable":true},"speaker_channels_count":{"maximum":8,"minimum":1,"type":"integer","description":"Optional speaker channels count used to indicate how many individual channels\r\nto transcribe for a given audio","format":"int32","nullable":true},"speakers_count":{"maximum":2147483647,"minimum":1,"type":"integer","description":"Optional count of speakers in the audio to improve diarization accuracy","format":"int32","nullable":true},"alternatives_count":{"maximum":3,"minimum":0,"type":"integer","description":"Optional count of alternatives to generate","format":"int32","nullable":true},"deletion_length_penalty":{"maximum":100,"minimum":-100,"type":"integer","format":"int32","nullable":true},"chunk_size":{"type":"string","description":"Optional chunk size to be sent to Revspeech for processing","format":"date-span","nullable":true},"transcriber":{"enum":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17],"type":"integer","format":"int32"},"verbatim":{"type":"boolean","description":"Instructs Revver to transcribe audio with all details including disfluencies and other verbal interactions\r\nsuch as laughter","nullable":true},"rush":{"type":"boolean","description":"Whether human order should be rushed at a greater cost to the customer","nullable":true},"segments_to_transcribe":{"type":"array","items":{"required":["end","start"],"type":"object","properties":{"start":{"type":"string","format":"date-span"},"end":{"type":"string","format":"date-span"}},"additionalProperties":false},"description":"Specific segments of the file to be transcribed by a human","nullable":true},"test_mode":{"type":"boolean","description":"Whether human order is test mode and should return a dummy transcript","nullable":true},"speaker_names":{"type":"array","items":{"required":["displayName"],"type":"object","properties":{"display_name":{"maxLength":50,"minLength":1,"type":"string"}},"additionalProperties":false},"description":"Speaker names for human transcription","nullable":true},"predict_topics":{"type":"boolean","description":"Whether to predict topics while performing speech rec","nullable":true},"top_nwords":{"maximum":100,"minimum":0,"type":"integer","description":"Returns the top n words of a transcript. Defaults to 0","format":"int32","nullable":true},"forced_alignment":{"type":"boolean","description":"Whether improved alignment should be used with transcription","nullable":true},"enable_fusion":{"type":"boolean","description":"Whether transcription should be done with fusion","nullable":true},"domain":{"enum":[0,1],"type":"integer","format":"int32"},"apply_duration_padding":{"type":"boolean","description":"If set adds one second of silence to the audio at the end","nullable":true},"diarization_type":{"enum":[0,10,20],"type":"integer","format":"int32"},"summarization_config":{"type":"object","properties":{"prompt":{"type":"string","description":"User defined prompt.","nullable":true},"model":{"enum":[0,1],"type":"integer","description":"Summarization model options for Rev.ai API","format":"int32"},"type":{"enum":[0,1],"type":"integer","description":"Summarization formatting options.","format":"int32"}},"additionalProperties":false,"description":"Summarization options."},"captions_config":{"type":"object","additionalProperties":false,"description":"Caption options."},"translation_config":{"required":["targetLanguages"],"type":"object","properties":{"target_languages":{"maxItems":5,"minItems":1,"type":"array","items":{"required":["language"],"type":"object","properties":{"model":{"enum":[0,1],"type":"integer","description":"Defines the type of models supported to translated the content","format":"int32"},"language":{"minLength":1,"type":"string","description":"Target language"}},"additionalProperties":false,"description":"Options for translation as part of Async job request for specific target language"},"description":"Target languages"}},"additionalProperties":false,"description":"Options for translation as part of Async job request"}},"additionalProperties":false,"readOnly":true,"nullable":true},"speechmatics_async":{"description":"JSON object that contains various groups of job configuration\nparameters. Based on the value of `type`, a type-specific object\nsuch as `transcription_config` is required to be present to\nspecify all configuration settings or parameters needed to\nprocess the job inputs as expected.\n\nIf the results of the job are to be forwarded on completion,\n`notification_config` can be provided with a list of callbacks\nto be made; no assumptions should be made about the order in\nwhich they will occur.\n\nCustomer specific job details or metadata can be supplied in\n`tracking`, and this information will be available where\npossible in the job results and in callbacks.\n","properties":{"alignment_config":{"required":["language"],"properties":{"language":{"type":"string"}},"example":{"language":"en"}},"transcription_config":{"required":["language"],"properties":{"language":{"type":"string","description":"Language model to process the audio input, normally specified as an ISO language code"},"domain":{"type":"string","description":"Request a specialized model based on 'language' but optimized for a particular field, e.g. \"finance\" or \"medical\"."},"output_locale":{"type":"string","description":"Language locale to be used when generating the transcription output, normally specified as an ISO language code"},"operating_point":{"type":"string","enum":["standard","enhanced"]},"additional_vocab":{"type":"array","x-omitempty":true,"items":{"type":"object","required":["content"],"properties":{"content":{"type":"string"},"sounds_like":{"type":"array","x-omitempty":true,"items":{"type":"string"}}}},"description":"List of custom words or phrases that should be recognized. Alternative pronunciations can be specified to aid recognition."},"punctuation_overrides":{"properties":{"sensitivity":{"type":"number","format":"float","minimum":0,"maximum":1,"description":"Ranges between zero and one. Higher values will produce more punctuation. The default is 0.5."},"permitted_marks":{"type":"array","items":{"type":"string","pattern":"^(.|all)$"},"description":"The punctuation marks which the client is prepared to accept in transcription output, or the special value 'all' (the default). Unsupported marks are ignored. This value is used to guide the transcription process."}},"description":"Control punctuation settings."},"diarization":{"type":"string","enum":["none","speaker","channel"],"description":"Specify whether speaker or channel labels are added to the transcript.\nThe default is `none`.\n  - **none**: no speaker or channel labels are added.\n  - **speaker**: speaker attribution is performed based on acoustic matching;\n             all input channels are mixed into a single stream for processing.\n  - **channel**: multiple input channels are processed individually and collated\n            into a single transcript."},"channel_diarization_labels":{"type":"array","x-omitempty":true,"items":{"type":"string","pattern":"^[A-Za-z0-9._]+$"},"description":"Transcript labels to use when using collating separate input channels."},"enable_entities":{"type":"boolean","description":"Include additional 'entity' objects in the transcription results (e.g. dates, numbers) and their original spoken form. These entities are interleaved with other types of results. The concatenation of these words is represented as a single entity with the concatenated written form present in the 'content' field. The entities contain a 'spoken_form' field, which can be used in place of the corresponding 'word' type results, in case a spoken form is preferred to a written form. They also contain a 'written_form', which can be used instead of the entity, if you want a breakdown of the words without spaces. They can still contain non-breaking spaces and other special whitespace characters, as they are considered part of the word for the formatting output. In case of a written_form, the individual word times are estimated and might not be accurate if the order of the words in the written form does not correspond to the order they were actually spoken (such as 'one hundred million dollars' and '$100 million')."},"max_delay_mode":{"type":"string","enum":["fixed","flexible"],"description":"Whether or not to enable flexible endpointing and allow the entity to continue to be spoken."},"transcript_filtering_config":{"description":"Configuration for applying filtering to the transcription","properties":{"remove_disfluencies":{"type":"boolean","description":"If true, words that are identified as disfluencies will be removed from the transcript. If false (default), they are tagged in the transcript as 'disfluency'."},"replacements":{"type":"array","x-omitempty":true,"items":{"additionalProperties":false,"type":"object","required":["from","to"],"properties":{"from":{"type":"string"},"to":{"type":"string"}}},"description":"A list of replacements to apply to the transcript. Each replacement is a pair of strings, where the first string is the pattern to be replaced and the second string is the replacement text."}}},"speaker_diarization_config":{"description":"Configuration for speaker diarization","properties":{"prefer_current_speaker":{"type":"boolean","description":"If true, the algorithm will prefer to stay with the current active speaker if it is a close enough match, even if other speakers may be closer.  This is useful for cases where we can flip incorrectly between similar speakers during a single speaker section.\""},"speaker_sensitivity":{"type":"number","format":"float","minimum":0,"maximum":1,"description":"Controls how sensitive the algorithm is in terms of keeping similar speakers separate, as opposed to combining them into a single speaker.  Higher values will typically lead to more speakers, as the degree of difference between speakers in order to allow them to remain distinct will be lower.  A lower value for this parameter will conversely guide the algorithm towards being less sensitive in terms of retaining similar speakers, and as such may lead to fewer speakers overall.  The default is 0.5."}}}},"example":{"language":"en","output_locale":"en-GB","additional_vocab":[{"content":"Speechmatics","sounds_like":["speechmatics"]},{"content":"gnocchi","sounds_like":["nyohki","nokey","nochi"]},{"content":"CEO","sounds_like":["C.E.O."]},{"content":"financial crisis"}],"diarization":"channel","channel_diarization_labels":["Caller","Agent"]}},"tracking":{"properties":{"title":{"type":"string","description":"The title of the job."},"reference":{"type":"string","description":"External system reference."},"tags":{"type":"array","x-omitempty":true,"items":{"type":"string"}},"details":{"type":"object","description":"Customer-defined JSON structure."}},"example":{"title":"ACME Q12018 Earnings Call","reference":"/data/clients/ACME/statements/segs/2018Q1-seg8","tags":["quick-review","segment"],"details":{"client":"ACME Corp","segment":8,"seg_start":963.201,"seg_end":1091.481}}},"output_config":{"x-omitempty":true,"type":"object","properties":{"srt_overrides":{"description":"Parameters that override default values of srt conversion. max_line_length: sets maximum count of characters per subtitle line including white space. max_lines: sets maximum count of lines in a subtitle section.","type":"object","properties":{"max_line_length":{"type":"integer"},"max_lines":{"type":"integer"}}}}},"translation_config":{"required":["target_languages"],"properties":{"target_languages":{"type":"array","maxItems":5,"items":{"type":"string"}}}},"language_identification_config":{"properties":{"expected_languages":{"type":"array","x-omitempty":true,"items":{"type":"string"}},"low_confidence_action":{"type":"string","enum":["allow","reject","use_default_language"],"description":"Action to take if all of the predicted languages are below the confidence threshold"},"default_language":{"type":"string"}}},"summarization_config":{"properties":{"content_type":{"type":"string","enum":["auto","informative","conversational"]},"summary_length":{"type":"string","enum":["brief","detailed"]},"summary_type":{"type":"string","enum":["paragraphs","bullets"]}}},"sentiment_analysis_config":{"type":"object"},"topic_detection_config":{"properties":{"topics":{"x-omitempty":true,"type":"array","items":{"type":"string"}}}},"auto_chapters_config":{"type":"object"},"audio_events_config":{"x-omitempty":true,"type":"object","properties":{"types":{"x-omitempty":true,"type":"array","items":{"type":"string"}}}}},"readOnly":true,"nullable":true},"recallai_async":{"type":"object","properties":{"language_code":{"enum":["auto","bg","ca","cs","da","de","el","en","en_au","en_uk","en_us","es","et","fi","fr","he","hi","hr","hu","id","it","ja","ko","lt","lv","ms","nl","no","pl","pt","ro","ru","sk","sv","th","tr","uk","vi","zh"],"type":"string","default":"auto","description":"Must be `en` in low latency mode. Docs: https://docs.recall.ai/docs/recallai-transcription\n\n* `auto` - auto\n* `bg` - bg\n* `ca` - ca\n* `cs` - cs\n* `da` - da\n* `de` - de\n* `el` - el\n* `en` - en\n* `en_au` - en_au\n* `en_uk` - en_uk\n* `en_us` - en_us\n* `es` - es\n* `et` - et\n* `fi` - fi\n* `fr` - fr\n* `he` - he\n* `hi` - hi\n* `hr` - hr\n* `hu` - hu\n* `id` - id\n* `it` - it\n* `ja` - ja\n* `ko` - ko\n* `lt` - lt\n* `lv` - lv\n* `ms` - ms\n* `nl` - nl\n* `no` - no\n* `pl` - pl\n* `pt` - pt\n* `ro` - ro\n* `ru` - ru\n* `sk` - sk\n* `sv` - sv\n* `th` - th\n* `tr` - tr\n* `uk` - uk\n* `vi` - vi\n* `zh` - zh"},"spelling":{"type":"array","items":{"$ref":"#/components/schemas/RecallaiSpellingEntry"},"description":"List of text strings to find/replace in the transcript."},"key_terms":{"type":"array","items":{"type":"string"},"description":"Increases the chances that these terms appear in the transcript over some sound-alikes."},"filter_profanity":{"type":"boolean","default":false}},"readOnly":true,"nullable":true,"title":"Recall.ai async transcription Settings","description":"Docs: https://docs.recall.ai/docs/recallai-transcription"},"google_speech_v2_async":{"description":"Docs: https://docs.cloud.google.com/speech-to-text/docs/reference/rest/v2/projects.locations.recognizers/batchRecognize","type":"object","properties":{"recognizer":{"description":"Required. The name of the Recognizer to use during recognition. The expected format is `projects/{project}/locations/{location}/recognizers/{recognizer}`. The {recognizer} segment may be set to `_` to use an empty implicit Recognizer.","type":"string","default":"projects/{project_id}/locations/global/recognizers/_"},"config":{"description":"Provides information to the Recognizer that specifies how to process the recognition request.","type":"object","properties":{"autoDecodingConfig":{"description":"Automatically detected decoding parameters. Supported for the following encodings: * WAV_LINEAR16: 16-bit signed little-endian PCM samples in a WAV container. * WAV_MULAW: 8-bit companded mulaw samples in a WAV container. * WAV_ALAW: 8-bit companded alaw samples in a WAV container. * RFC4867_5_AMR: AMR frames with an rfc4867.5 header. * RFC4867_5_AMRWB: AMR-WB frames with an rfc4867.5 header. * FLAC: FLAC frames in the \"native FLAC\" container format. * MP3: MPEG audio frames with optional (ignored) ID3 metadata. * OGG_OPUS: Opus audio frames in an Ogg container. * WEBM_OPUS: Opus audio frames in a WebM container. * MP4_AAC: AAC audio frames in an MP4 container. * M4A_AAC: AAC audio frames in an M4A container. * MOV_AAC: AAC audio frames in an MOV container.","type":"object","properties":{}},"explicitDecodingConfig":{"description":"Explicitly specified decoding parameters.","type":"object","properties":{"encoding":{"description":"Required. Encoding of the audio data sent for recognition.","type":"string","enum":["AUDIO_ENCODING_UNSPECIFIED","LINEAR16","MULAW","ALAW","AMR","AMR_WB","FLAC","MP3","OGG_OPUS","WEBM_OPUS","MP4_AAC","M4A_AAC","MOV_AAC"]},"sampleRateHertz":{"description":"Optional. Sample rate in Hertz of the audio data sent for recognition. Valid values are: 8000-48000, and 16000 is optimal. For best results, set the sampling rate of the audio source to 16000 Hz. If that's not possible, use the native sample rate of the audio source (instead of resampling). Note that this field is marked as OPTIONAL for backward compatibility reasons. It is (and has always been) effectively REQUIRED.","type":"integer","format":"int32"},"audioChannelCount":{"description":"Optional. Number of channels present in the audio data sent for recognition. Note that this field is marked as OPTIONAL for backward compatibility reasons. It is (and has always been) effectively REQUIRED. The maximum allowed value is 8.","type":"integer","format":"int32"}}},"model":{"description":"Optional. Which model to use for recognition requests. Select the model best suited to your domain to get best results. Guidance for choosing which model to use can be found in the [Transcription Models Documentation](https://cloud.google.com/speech-to-text/v2/docs/transcription-model) and the models supported in each region can be found in the [Table Of Supported Models](https://cloud.google.com/speech-to-text/v2/docs/speech-to-text-supported-languages).","type":"string"},"languageCodes":{"description":"Optional. The language of the supplied audio as a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. Language tags are normalized to BCP-47 before they are used eg \"en-us\" becomes \"en-US\". Supported languages for each model are listed in the [Table of Supported Models](https://cloud.google.com/speech-to-text/v2/docs/speech-to-text-supported-languages). If additional languages are provided, recognition result will contain recognition in the most likely language detected. The recognition result will include the language tag of the language detected in the audio.","type":"array","items":{"type":"string"}},"features":{"description":"Available recognition features.","type":"object","properties":{"profanityFilter":{"description":"If set to `true`, the server will attempt to filter out profanities, replacing all but the initial character in each filtered word with asterisks, for instance, \"f***\". If set to `false` or omitted, profanities won't be filtered out.","type":"boolean"},"enableWordTimeOffsets":{"description":"If `true`, the top result includes a list of words and the start and end time offsets (timestamps) for those words. If `false`, no word-level time offset information is returned. The default is `false`.","type":"boolean"},"enableWordConfidence":{"description":"If `true`, the top result includes a list of words and the confidence for those words. If `false`, no word-level confidence information is returned. The default is `false`.","type":"boolean"},"enableAutomaticPunctuation":{"description":"If `true`, adds punctuation to recognition result hypotheses. This feature is only available in select languages. The default `false` value does not add punctuation to result hypotheses.","type":"boolean"},"enableSpokenPunctuation":{"description":"The spoken punctuation behavior for the call. If `true`, replaces spoken punctuation with the corresponding symbols in the request. For example, \"how are you question mark\" becomes \"how are you?\". See https://cloud.google.com/speech-to-text/docs/spoken-punctuation for support. If `false`, spoken punctuation is not replaced.","type":"boolean"},"enableSpokenEmojis":{"description":"The spoken emoji behavior for the call. If `true`, adds spoken emoji formatting for the request. This will replace spoken emojis with the corresponding Unicode symbols in the final transcript. If `false`, spoken emojis are not replaced.","type":"boolean"},"multiChannelMode":{"description":"Mode for recognizing multi-channel audio.","type":"string","enum":["MULTI_CHANNEL_MODE_UNSPECIFIED","SEPARATE_RECOGNITION_PER_CHANNEL"]},"diarizationConfig":{"description":"Configuration to enable speaker diarization.","type":"object","properties":{"minSpeakerCount":{"description":"Optional. The system automatically determines the number of speakers. This value is not currently used.","type":"integer","format":"int32"},"maxSpeakerCount":{"description":"Optional. The system automatically determines the number of speakers. This value is not currently used.","type":"integer","format":"int32"}}},"maxAlternatives":{"description":"Maximum number of recognition hypotheses to be returned. The server may return fewer than `max_alternatives`. Valid values are `0`-`30`. A value of `0` or `1` will return a maximum of one. If omitted, will return a maximum of one.","type":"integer","format":"int32"}}},"adaptation":{"description":"Provides \"hints\" to the speech recognizer to favor specific words and phrases in the results. PhraseSets can be specified as an inline resource, or a reference to an existing PhraseSet resource.","type":"object","properties":{"phraseSets":{"description":"A list of inline or referenced PhraseSets.","type":"array","items":{"description":"A biasing PhraseSet, which can be either a string referencing the name of an existing PhraseSets resource, or an inline definition of a PhraseSet.","type":"object","properties":{"phraseSet":{"description":"The name of an existing PhraseSet resource. The user must have read access to the resource and it must not be deleted.","type":"string"},"inlinePhraseSet":{"description":"PhraseSet for biasing in speech recognition. A PhraseSet is used to provide \"hints\" to the speech recognizer to favor specific words and phrases in the results.","type":"object","properties":{"name":{"description":"Output only. Identifier. The resource name of the PhraseSet. Format: `projects/{project}/locations/{location}/phraseSets/{phrase_set}`.","readOnly":true,"type":"string"},"uid":{"description":"Output only. System-assigned unique identifier for the PhraseSet.","readOnly":true,"type":"string"},"phrases":{"description":"A list of word and phrases.","type":"array","items":{"description":"A Phrase contains words and phrase \"hints\" so that the speech recognition is more likely to recognize them. This can be used to improve the accuracy for specific words and phrases, for example, if specific commands are typically spoken by the user. This can also be used to add additional words to the vocabulary of the recognizer. List items can also include CustomClass references containing groups of words that represent common concepts that occur in natural language.","type":"object","properties":{"value":{"description":"The phrase itself.","type":"string"},"boost":{"description":"Hint Boost. Overrides the boost set at the phrase set level. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost values would correspond to anti-biasing. Anti-biasing is not enabled, so negative boost values will return an error. Boost values must be between 0 and 20. Any values outside that range will return an error. We recommend using a binary search approach to finding the optimal value for your use case as well as adding phrases both with and without boost to your requests.","type":"number","format":"float"}}}},"boost":{"description":"Hint Boost. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Valid `boost` values are between 0 (exclusive) and 20. We recommend using a binary search approach to finding the optimal value for your use case as well as adding phrases both with and without boost to your requests.","type":"number","format":"float"},"displayName":{"description":"User-settable, human-readable name for the PhraseSet. Must be 63 characters or less.","type":"string"},"state":{"description":"Output only. The PhraseSet lifecycle state.","readOnly":true,"type":"string","enum":["STATE_UNSPECIFIED","ACTIVE","DELETED"]},"createTime":{"description":"Output only. Creation time.","readOnly":true,"type":"string","format":"google-datetime"},"updateTime":{"description":"Output only. The most recent time this resource was modified.","readOnly":true,"type":"string","format":"google-datetime"},"deleteTime":{"description":"Output only. The time at which this resource was requested for deletion.","readOnly":true,"type":"string","format":"google-datetime"},"expireTime":{"description":"Output only. The time at which this resource will be purged.","readOnly":true,"type":"string","format":"google-datetime"},"annotations":{"description":"Allows users to store small amounts of arbitrary data. Both the key and the value must be 63 characters or less each. At most 100 annotations.","type":"object","additionalProperties":{"type":"string"}},"etag":{"description":"Output only. This checksum is computed by the server based on the value of other fields. This may be sent on update, undelete, and delete requests to ensure the client has an up-to-date value before proceeding.","readOnly":true,"type":"string"},"reconciling":{"description":"Output only. Whether or not this PhraseSet is in the process of being updated.","readOnly":true,"type":"boolean"},"kmsKeyName":{"description":"Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.","readOnly":true,"type":"string"},"kmsKeyVersionName":{"description":"Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.","readOnly":true,"type":"string"}}}}}},"customClasses":{"description":"A list of inline CustomClasses. Existing CustomClass resources can be referenced directly in a PhraseSet.","type":"array","items":{"description":"CustomClass for biasing in speech recognition. Used to define a set of words or phrases that represents a common concept or theme likely to appear in your audio, for example a list of passenger ship names.","type":"object","properties":{"name":{"description":"Output only. Identifier. The resource name of the CustomClass. Format: `projects/{project}/locations/{location}/customClasses/{custom_class}`.","readOnly":true,"type":"string"},"uid":{"description":"Output only. System-assigned unique identifier for the CustomClass.","readOnly":true,"type":"string"},"displayName":{"description":"Optional. User-settable, human-readable name for the CustomClass. Must be 63 characters or less.","type":"string"},"items":{"description":"A collection of class items.","type":"array","items":{"description":"An item of the class.","type":"object","properties":{"value":{"description":"The class item's value.","type":"string"}}}},"state":{"description":"Output only. The CustomClass lifecycle state.","readOnly":true,"type":"string","enum":["STATE_UNSPECIFIED","ACTIVE","DELETED"]},"createTime":{"description":"Output only. Creation time.","readOnly":true,"type":"string","format":"google-datetime"},"updateTime":{"description":"Output only. The most recent time this resource was modified.","readOnly":true,"type":"string","format":"google-datetime"},"deleteTime":{"description":"Output only. The time at which this resource was requested for deletion.","readOnly":true,"type":"string","format":"google-datetime"},"expireTime":{"description":"Output only. The time at which this resource will be purged.","readOnly":true,"type":"string","format":"google-datetime"},"annotations":{"description":"Optional. Allows users to store small amounts of arbitrary data. Both the key and the value must be 63 characters or less each. At most 100 annotations.","type":"object","additionalProperties":{"type":"string"}},"etag":{"description":"Output only. This checksum is computed by the server based on the value of other fields. This may be sent on update, undelete, and delete requests to ensure the client has an up-to-date value before proceeding.","readOnly":true,"type":"string"},"reconciling":{"description":"Output only. Whether or not this CustomClass is in the process of being updated.","readOnly":true,"type":"boolean"},"kmsKeyName":{"description":"Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the CustomClass is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.","readOnly":true,"type":"string"},"kmsKeyVersionName":{"description":"Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which the CustomClass is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.","readOnly":true,"type":"string"}}}}}},"transcriptNormalization":{"description":"Transcription normalization configuration. Use transcription normalization to automatically replace parts of the transcript with phrases of your choosing. For StreamingRecognize, this normalization only applies to stable partial transcripts (stability > 0.8) and final transcripts.","type":"object","properties":{"entries":{"description":"A list of replacement entries. We will perform replacement with one entry at a time. For example, the second entry in [\"cat\" => \"dog\", \"mountain cat\" => \"mountain dog\"] will never be applied because we will always process the first entry before it. At most 100 entries.","type":"array","items":{"description":"A single replacement configuration.","type":"object","properties":{"search":{"description":"What to replace. Max length is 100 characters.","type":"string"},"replace":{"description":"What to replace with. Max length is 100 characters.","type":"string"},"caseSensitive":{"description":"Whether the search is case sensitive.","type":"boolean"}}}}}},"translationConfig":{"description":"Translation configuration. Use to translate the given audio into text for the desired language.","type":"object","properties":{"targetLanguage":{"description":"Required. The language code to translate to.","type":"string"}}},"denoiserConfig":{"description":"Denoiser config. May not be supported for all models and may have no effect.","type":"object","properties":{"denoiseAudio":{"description":"Denoise audio before sending to the transcription model.","type":"boolean"},"snrThreshold":{"description":"Signal-to-Noise Ratio (SNR) threshold for the denoiser. Here SNR means the loudness of the speech signal. Audio with an SNR below this threshold, meaning the speech is too quiet, will be prevented from being sent to the transcription model. If snr_threshold=0, no filtering will be applied.","type":"number","format":"float"}}}}},"configMask":{"description":"The list of fields in config that override the values in the default_recognition_config of the recognizer during this recognition request. If no mask is provided, all given fields in config override the values in the recognizer for this recognition request. If a mask is provided, only the fields listed in the mask override the config in the recognizer for this recognition request. If a wildcard (`*`) is provided, config completely overrides and replaces the config in the recognizer for this recognition request.","type":"string","format":"google-fieldmask"}},"readOnly":true,"nullable":true,"title":"Google Cloud Speech To Text V2 transcription service"},"aws_transcribe_async":{"type":"object","readOnly":true,"nullable":true,"title":"AWS Transcribe batch transcription service","description":"Docs: https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html"},"elevenlabs_async":{"properties":{"model_id":{"type":"string","enum":["scribe_v1","scribe_v2"],"title":"Model Id","description":"The ID of the model to use for transcription."},"language_code":{"anyOf":[{"type":"string"},{"type":"string","nullable":true}],"title":"Language Code","description":"An ISO-639-1 or ISO-639-3 language_code corresponding to the language of the audio file. Can sometimes improve transcription performance if known beforehand. Defaults to null, in this case the language is predicted automatically."},"tag_audio_events":{"type":"boolean","title":"Tag Audio Events","description":"Whether to tag audio events like (laughter), (footsteps), etc. in the transcription.","default":true},"num_speakers":{"anyOf":[{"type":"integer","maximum":32,"minimum":1},{"type":"string","nullable":true}],"title":"Num Speakers","description":"The maximum amount of speakers talking in the uploaded file. Can help with predicting who speaks when. The maximum amount of speakers that can be predicted is 32. Defaults to null, in this case the amount of speakers is set to the maximum value the model supports."},"diarize":{"type":"boolean","title":"Diarize","description":"Whether to annotate which speaker is currently talking in the uploaded file.","default":false},"diarization_threshold":{"anyOf":[{"type":"number","maximum":0.4,"minimum":0.1},{"type":"string","nullable":true}],"title":"Diarization Threshold","description":"Diarization threshold to apply during speaker diarization. A higher value means there will be a lower chance of one speaker being diarized as two different speakers but also a higher chance of two different speakers being diarized as one speaker (less total speakers predicted). A low value means there will be a higher chance of one speaker being diarized as two different speakers but also a lower chance of two different speakers being diarized as one speaker (more total speakers predicted). Can only be set when diarize=True and num_speakers=None. Defaults to None, in which case we will choose a threshold based on the model_id (0.22 usually)."},"additional_formats":{"items":{"oneOf":[{"properties":{"include_speakers":{"type":"boolean","title":"Include Speakers","default":true},"include_timestamps":{"type":"boolean","title":"Include Timestamps","default":true},"format":{"type":"string","title":"Format","enum":["segmented_json"]},"segment_on_silence_longer_than_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Segment On Silence Longer Than S"},"max_segment_duration_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Max Segment Duration S"},"max_segment_chars":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Segment Chars"}},"type":"object","required":["format"],"title":"SegmentedJsonExportOptions"},{"properties":{"include_speakers":{"type":"boolean","title":"Include Speakers","default":true},"include_timestamps":{"type":"boolean","title":"Include Timestamps","default":true},"format":{"type":"string","title":"Format","enum":["docx"]},"segment_on_silence_longer_than_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Segment On Silence Longer Than S"},"max_segment_duration_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Max Segment Duration S"},"max_segment_chars":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Segment Chars"}},"type":"object","required":["format"],"title":"DocxExportOptions"},{"properties":{"include_speakers":{"type":"boolean","title":"Include Speakers","default":true},"include_timestamps":{"type":"boolean","title":"Include Timestamps","default":true},"format":{"type":"string","title":"Format","enum":["pdf"]},"segment_on_silence_longer_than_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Segment On Silence Longer Than S"},"max_segment_duration_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Max Segment Duration S"},"max_segment_chars":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Segment Chars"}},"type":"object","required":["format"],"title":"PdfExportOptions"},{"properties":{"max_characters_per_line":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Characters Per Line","default":100},"include_speakers":{"type":"boolean","title":"Include Speakers","default":true},"include_timestamps":{"type":"boolean","title":"Include Timestamps","default":true},"format":{"type":"string","title":"Format","enum":["txt"]},"segment_on_silence_longer_than_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Segment On Silence Longer Than S"},"max_segment_duration_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Max Segment Duration S"},"max_segment_chars":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Segment Chars"}},"type":"object","required":["format"],"title":"TxtExportOptions"},{"properties":{"include_speakers":{"type":"boolean","title":"Include Speakers","default":true},"include_timestamps":{"type":"boolean","title":"Include Timestamps","default":true},"format":{"type":"string","title":"Format","enum":["html"]},"segment_on_silence_longer_than_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Segment On Silence Longer Than S"},"max_segment_duration_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Max Segment Duration S"},"max_segment_chars":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Segment Chars"}},"type":"object","required":["format"],"title":"HtmlExportOptions"},{"properties":{"max_characters_per_line":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Characters Per Line","default":42},"include_speakers":{"type":"boolean","title":"Include Speakers","default":false},"include_timestamps":{"type":"boolean","title":"Include Timestamps","default":true},"format":{"type":"string","title":"Format","enum":["srt"]},"segment_on_silence_longer_than_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Segment On Silence Longer Than S","default":0.8},"max_segment_duration_s":{"anyOf":[{"type":"number"},{"type":"string","nullable":true}],"title":"Max Segment Duration S","default":4},"max_segment_chars":{"anyOf":[{"type":"integer"},{"type":"string","nullable":true}],"title":"Max Segment Chars","default":84}},"type":"object","required":["format"],"title":"SrtExportOptions"}],"title":"ExportOptions","discriminator":{"propertyName":"format","mapping":{"docx":"#/components/schemas/DocxExportOptions","html":"#/components/schemas/HtmlExportOptions","pdf":"#/components/schemas/PdfExportOptions","segmented_json":"#/components/schemas/SegmentedJsonExportOptions","srt":"#/components/schemas/SrtExportOptions","txt":"#/components/schemas/TxtExportOptions"}}},"type":"array","maxItems":10,"title":"AdditionalFormats"},"webhook_id":{"anyOf":[{"type":"string"},{"type":"string","nullable":true}],"title":"Webhook Id","description":"Optional specific webhook ID to send the transcription result to. Only valid when webhook is set to true. If not provided, transcription will be sent to all configured speech-to-text webhooks."},"temperature":{"anyOf":[{"type":"number","maximum":2,"minimum":0},{"type":"string","nullable":true}],"title":"Temperature","description":"Controls the randomness of the transcription output. Accepts values between 0.0 and 2.0, where higher values result in more diverse and less deterministic results. If omitted, we will use a temperature based on the model you selected which is usually 0."},"seed":{"anyOf":[{"type":"integer","maximum":2147483647,"minimum":0},{"type":"string","nullable":true}],"title":"Seed","description":"If specified, our system will make a best effort to sample deterministically, such that repeated requests with the same seed and parameters should return the same result. Determinism is not guaranteed. Must be an integer between 0 and 2147483647."},"webhook_metadata":{"anyOf":[{"type":"string"},{"type":"object"},{"type":"string","nullable":true}],"title":"Webhook Metadata","description":"Optional metadata to be included in the webhook response. This should be a JSON string representing an object with a maximum depth of 2 levels and maximum size of 16KB. Useful for tracking internal IDs, job references, or other contextual information."},"entity_detection":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"string","nullable":true}],"title":"Entity Detection","description":"Detect entities in the transcript. Can be 'all' to detect all entities, a single entity type or category string, or a list of entity types/categories. Categories include 'pii', 'phi', 'pci', 'other', 'offensive_language'. When enabled, detected entities will be returned in the 'entities' field with their text, type, and character positions."},"keyterms":{"items":{"type":"string"},"type":"array","title":"Keyterms","description":"A list of keyterms to bias the transcription towards.           The keyterms are words or phrases you want the model to recognise more accurately.           The number of keyterms cannot exceed 100.           The length of each keyterm must be less than 50 characters.           Keyterms can contain at most 5 words (after normalisation).           For example [\"hello\", \"world\", \"technical term\"]","default":[]}},"type":"object","required":["model_id"],"title":"Eleven Labs batch transcription service","readOnly":true,"nullable":true,"description":"Docs: https://elevenlabs.io/docs/api-reference/speech-to-text"},"assembly_ai_async_chunked":{"properties":{"audio_end_at":{"x-label":"Audio end at","description":"The point in time, in milliseconds, to stop transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer"},"audio_start_from":{"x-label":"Audio start from","description":"The point in time, in milliseconds, to begin transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer"},"auto_chapters":{"x-label":"Auto chapters","description":"Enable [Auto Chapters](https://www.assemblyai.com/docs/speech-understanding/auto-chapters), can be true or false","type":"boolean","default":false},"auto_highlights":{"x-label":"Key phrases","description":"Enable [Key Phrases](https://www.assemblyai.com/docs/speech-understanding/key-phrases), either true or false","type":"boolean","default":false},"content_safety":{"x-label":"Content Moderation","description":"Enable [Content Moderation](https://www.assemblyai.com/docs/content-moderation), can be true or false","type":"boolean","default":false},"content_safety_confidence":{"x-label":"Content Moderation confidence","description":"The confidence threshold for the [Content Moderation](https://www.assemblyai.com/docs/content-moderation) model. Values must be between 25 and 100.","type":"integer","default":50,"minimum":25,"maximum":100},"custom_spelling":{"x-label":"Custom spellings","description":"Customize how words are spelled and formatted using to and from values. See [Custom Spelling](https://www.assemblyai.com/docs/pre-recorded-audio/custom-spelling) for more details.","type":"array","items":{"x-label":"Custom spelling","description":"Object containing words or phrases to replace, and the word or phrase to replace with","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"from":{"x-label":"From","description":"Words or phrases to replace","type":"array","items":{"x-label":"Word or phrase","description":"Word or phrase to replace","type":"string"}},"to":{"x-label":"To","description":"Word to replace with","type":"string"}},"required":["from","to"],"example":{"from":["dicarlo"],"to":"Decarlo"}}},"disfluencies":{"x-label":"Disfluencies","description":"Transcribe [Filler Words](https://www.assemblyai.com/docs/pre-recorded-audio/filler-words), like \"umm\", in your media file; can be true or false","type":"boolean","default":false},"entity_detection":{"x-label":"Entity Detection","description":"Enable [Entity Detection](https://www.assemblyai.com/docs/speech-understanding/entity-detection), can be true or false","type":"boolean","default":false},"filter_profanity":{"x-label":"Filter profanity","description":"Filter profanity from the transcribed text, can be true or false. See [Profanity Filtering](https://www.assemblyai.com/docs/profanity-filtering) for more details.","type":"boolean","default":false},"format_text":{"x-label":"Format text","description":"Enable [Text Formatting](https://www.assemblyai.com/docs/pre-recorded-audio), can be true or false","type":"boolean","default":true},"iab_categories":{"x-label":"Topic Detection","description":"Enable [Topic Detection](https://www.assemblyai.com/docs/speech-understanding/topic-detection), can be true or false","type":"boolean","default":false},"keyterms_prompt":{"x-label":"Keyterms prompt","description":"Improve accuracy with up to 200 (for Universal-2) or 1000 (for Universal-3-Pro) domain-specific words or phrases (maximum 6 words per phrase). See [Keyterms Prompting](https://www.assemblyai.com/docs/pre-recorded-audio/keyterms-prompting) for more details.\n","type":"array","items":{"x-label":"Keyterm","type":"string"}},"language_code":{"x-label":"Language code","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","oneOf":[{"anyOf":[{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"}}},{"type":"string"}]},{"type":"string","nullable":true}],"default":"en_us","x-ts-type":"LiteralUnion<TranscriptLanguageCode, string> | null","x-go-type":"TranscriptLanguageCode"},"language_codes":{"description":"The language codes of your audio file. Used for [Code switching](/docs/speech-to-text/pre-recorded-audio/code-switching)\nOne of the values specified must be `en`.\n","type":"array","items":{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"}}},"nullable":true},"language_confidence_threshold":{"x-label":"Language confidence threshold","description":"The confidence threshold for the automatically detected language.\nAn error will be returned if the language confidence is below this threshold.\nDefaults to 0. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0},"language_detection":{"x-label":"Language detection","description":"Enable [Automatic language detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection), either true or false.","type":"boolean","default":false},"language_detection_options":{"x-label":"Specify options for Automatic Language Detection.","description":"Specify options for [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection).","type":"object","additionalProperties":false,"properties":{"expected_languages":{"x-label":"Expected languages","description":"List of languages expected in the audio file. Defaults to `[\"all\"]` when unspecified. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.","type":"array","items":{"x-label":"language","type":"string"}},"fallback_language":{"x-label":"Fallback language","description":"If the detected language of the audio file is not in the list of expected languages, the `fallback_language` is used. Specify `[\"auto\"]` to let our model choose the fallback language from `expected_languages` with the highest confidence score. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"string","default":"auto"},"code_switching":{"x-label":"Code switching","description":"Whether [code switching](/docs/speech-to-text/pre-recorded-audio/code-switching) should be detected.\n","type":"boolean","default":false},"code_switching_confidence_threshold":{"x-label":"Code switching confidence threshold","description":"The confidence threshold for [code switching](/docs/speech-to-text/pre-recorded-audio/code-switching) detection. If the code switching confidence is below this threshold, the transcript will be processed in the language with the highest `language_detection_confidence` score.\n","type":"number","minimum":0,"maximum":1,"default":0.3}}},"multichannel":{"x-label":"Multichannel","description":"Enable [Multichannel](https://www.assemblyai.com/docs/pre-recorded-audio/multichannel) transcription, can be true or false.","type":"boolean","default":false},"prompt":{"x-label":"Prompt","description":"Provide natural language prompting of up to 1,500 words of contextual information to the model. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for best practices.\n\nNote: This parameter is only supported for the Universal-3-Pro model.\n","type":"string"},"punctuate":{"x-label":"Punctuate","description":"Enable [Automatic Punctuation](https://www.assemblyai.com/docs/pre-recorded-audio), can be true or false","type":"boolean","default":true},"redact_pii":{"x-label":"Redact PII","description":"Redact PII from the transcribed text using the Redact PII model, can be true or false. See [PII Redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"boolean","default":false},"redact_pii_audio":{"x-label":"Redact PII audio","description":"Generate a copy of the original media file with spoken PII \"beeped\" out, can be true or false. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","type":"boolean","default":false},"redact_pii_audio_options":{"x-label":"Specify options for PII redacted audio files.","description":"Specify options for [PII redacted audio](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) files.","type":"object","additionalProperties":false,"properties":{"return_redacted_no_speech_audio":{"x-label":"Return redacted no speech audio","description":"By default, audio redaction provides redacted audio URLs only when speech is detected. However, if your use-case specifically requires redacted audio files even for silent audio files without any dialogue, you can opt to receive these URLs by setting this parameter to `true`.","type":"boolean","default":false}}},"redact_pii_audio_quality":{"x-label":"Redact PII audio quality","type":"string","description":"Controls the filetype of the audio created by redact_pii_audio. Currently supports mp3 (default) and wav. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","x-fern-sdk-group-name":"transcripts","enum":["mp3","wav"],"x-fern-enum":{"mp3":{"description":"MP3 audio format is lower quality and lower size than WAV.","casing":{"camel":"mp3","snake":"mp3","pascal":"Mp3","screamingSnake":"MP3"}},"wav":{"description":"WAV audio format is the highest quality (no compression) and larger size than MP3."}},"x-aai-enum":{"mp3":{"label":"MP3"},"wav":{"label":"WAV"}},"example":"mp3"},"redact_pii_policies":{"x-label":"Redact PII policies","description":"The list of PII Redaction policies to enable. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"array","items":{"x-label":"PII policy","description":"The type of PII to redact","x-fern-sdk-group-name":"transcripts","type":"string","enum":["account_number","banking_information","blood_type","credit_card_cvv","credit_card_expiration","credit_card_number","date","date_interval","date_of_birth","drivers_license","drug","duration","email_address","event","filename","gender_sexuality","healthcare_number","injury","ip_address","language","location","marital_status","medical_condition","medical_process","money_amount","nationality","number_sequence","occupation","organization","passport_number","password","person_age","person_name","phone_number","physical_attribute","political_affiliation","religion","statistics","time","url","us_social_security_number","username","vehicle_id","zodiac_sign"],"x-fern-enum":{"account_number":{"description":"Customer account or membership identification number (e.g., Policy No. 10042992, Member ID: HZ-5235-001)"},"banking_information":{"description":"Banking information, including account and routing numbers"},"blood_type":{"description":"Blood type (e.g., O-, AB positive)"},"credit_card_cvv":{"description":"Credit card verification code (e.g., CVV: 080)"},"credit_card_expiration":{"description":"Expiration date of a credit card"},"credit_card_number":{"description":"Credit card number"},"date":{"description":"Specific calendar date (e.g., December 18)"},"date_interval":{"description":"Broader time periods, including date ranges, months, seasons, years, and decades (e.g., 2020-2021, 5-9 May, January 1984)"},"date_of_birth":{"description":"Date of birth (e.g., Date of Birth: March 7,1961)"},"drivers_license":{"description":"Driver's license number. (e.g., DL# 356933-540)"},"drug":{"description":"Medications, vitamins, or supplements (e.g., Advil, Acetaminophen, Panadol)"},"duration":{"description":"Periods of time, specified as a number and a unit of time (e.g., 8 months, 2 years)"},"email_address":{"description":"Email address (e.g., support@assemblyai.com)"},"event":{"description":"Name of an event or holiday (e.g., Olympics, Yom Kippur)"},"filename":{"description":"Names of computer files, including the extension or filepath (e.g., Taxes/2012/brad-tax-returns.pdf)"},"gender_sexuality":{"description":"Terms indicating gender identity or sexual orientation, including slang terms (e.g., female, bisexual, trans)"},"healthcare_number":{"description":"Healthcare numbers and health plan beneficiary numbers (e.g., Policy No.: 5584-486-674-YM)"},"injury":{"description":"Bodily injury (e.g., I broke my arm, I have a sprained wrist)"},"ip_address":{"description":"Internet IP address, including IPv4 and IPv6 formats (e.g., 192.168.0.1)"},"language":{"description":"Name of a natural language (e.g., Spanish, French)"},"location":{"description":"Any Location reference including mailing address, postal code, city, state, province, country, or coordinates. (e.g., Lake Victoria, 145 Windsor St., 90210)"},"marital_status":{"description":"Terms indicating marital status (e.g., Single, common-law, ex-wife, married)"},"medical_condition":{"description":"Name of a medical condition, disease, syndrome, deficit, or disorder (e.g., chronic fatigue syndrome, arrhythmia, depression)"},"medical_process":{"description":"Medical process, including treatments, procedures, and tests (e.g., heart surgery, CT scan)"},"money_amount":{"description":"Name and/or amount of currency (e.g., 15 pesos, $94.50)"},"nationality":{"description":"Terms indicating nationality, ethnicity, or race (e.g., American, Asian, Caucasian)"},"number_sequence":{"description":"Numerical PII (including alphanumeric strings) that doesn't fall under other categories"},"occupation":{"description":"Job title or profession (e.g., professor, actors, engineer, CPA)"},"organization":{"description":"Name of an organization (e.g., CNN, McDonalds, University of Alaska, Northwest General Hospital)"},"passport_number":{"description":"Passport numbers, issued by any country (e.g., PA4568332, NU3C6L86S12)"},"password":{"description":"Account passwords, PINs, access keys, or verification answers (e.g., 27%alfalfa, temp1234, My mother's maiden name is Smith)"},"person_age":{"description":"Number associated with an age (e.g., 27, 75)"},"person_name":{"description":"Name of a person (e.g., Bob, Doug Jones, Dr. Kay Martinez, MD)"},"phone_number":{"description":"Telephone or fax number"},"physical_attribute":{"description":"Distinctive bodily attributes, including terms indicating race (e.g., I'm 190cm tall, He belongs to the Black students' association)"},"political_affiliation":{"description":"Terms referring to a political party, movement, or ideology (e.g., Republican, Liberal)"},"religion":{"description":"Terms indicating religious affiliation (e.g., Hindu, Catholic)"},"statistics":{"description":"Medical statistics (e.g., 18%, 18 percent)"},"time":{"description":"Expressions indicating clock times (e.g., 19:37:28, 10pm EST)"},"url":{"description":"Internet addresses (e.g., https://www.assemblyai.com/)"},"us_social_security_number":{"description":"Social Security Number or equivalent"},"username":{"description":"Usernames, login names, or handles (e.g., @AssemblyAI)"},"vehicle_id":{"description":"Vehicle identification numbers (VINs), vehicle serial numbers, and license plate numbers (e.g., 5FNRL38918B111818, BIF7547)"},"zodiac_sign":{"description":"Names of Zodiac signs (e.g., Aries, Taurus)"}},"x-aai-enum":{"account_number":{"label":"Account number"},"banking_information":{"label":"Banking information"},"blood_type":{"label":"Blood type"},"credit_card_cvv":{"label":"Credit card CVV"},"credit_card_expiration":{"label":"Credit card expiration"},"credit_card_number":{"label":"Credit card number"},"date":{"label":"Date"},"date_interval":{"label":"Date interval"},"date_of_birth":{"label":"Date of birth"},"drivers_license":{"label":"Driver's license"},"drug":{"label":"Drug"},"duration":{"label":"Duration"},"email_address":{"label":"Email address"},"event":{"label":"Event"},"filename":{"label":"Filename"},"gender_sexuality":{"label":"Gender sexuality"},"healthcare_number":{"label":"Healthcare number"},"injury":{"label":"Injury"},"ip_address":{"label":"IP address"},"language":{"label":"Language"},"location":{"label":"Location"},"marital_status":{"label":"Marital status"},"medical_condition":{"label":"Medical condition"},"medical_process":{"label":"Medical process"},"money_amount":{"label":"Money amount"},"nationality":{"label":"Nationality"},"number_sequence":{"label":"Number sequence"},"occupation":{"label":"Occupation"},"organization":{"label":"Organization"},"passport_number":{"label":"Passport number"},"password":{"label":"Password"},"person_age":{"label":"Person age"},"person_name":{"label":"Person name"},"phone_number":{"label":"Phone number"},"physical_attribute":{"label":"Physical attribute"},"political_affiliation":{"label":"Political affiliation"},"religion":{"label":"Religion"},"statistics":{"label":"Statistics"},"time":{"label":"Time"},"url":{"label":"URL"},"us_social_security_number":{"label":"US Social Security Number"},"username":{"label":"Username"},"vehicle_id":{"label":"Vehicle ID"},"zodiac_sign":{"label":"Zodiac sign"}}}},"redact_pii_sub":{"x-label":"Redact PII substitution","description":"The replacement logic for detected PII, can be `entity_type` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","oneOf":[{"x-label":"Redact PII substitution","type":"string","x-fern-sdk-group-name":"transcripts","description":"The replacement logic for detected PII, can be `entity_name` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","enum":["entity_name","hash"],"x-aai-enum":{"entity_name":{"label":"Entity name"},"hash":{"label":"Hash"}}},{"type":"string","nullable":true}],"default":"hash"},"sentiment_analysis":{"x-label":"Sentiment Analysis","description":"Enable [Sentiment Analysis](https://www.assemblyai.com/docs/speech-understanding/sentiment-analysis), can be true or false","type":"boolean","default":false},"speaker_labels":{"x-label":"Speaker labels","description":"Enable [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization), can be true or false","type":"boolean","default":false},"speaker_options":{"x-label":"Specify options for speaker diarization.","description":"Specify options for [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers). Use this to set a range of possible speakers.","type":"object","additionalProperties":false,"properties":{"min_speakers_expected":{"x-label":"Minimum speakers expected","description":"The minimum number of speakers expected in the audio file. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers) for more details.","type":"integer","default":1},"max_speakers_expected":{"x-label":"Maximum speakers expected","description":"<Warning>Setting this parameter too high may hurt model accuracy</Warning>\nThe maximum number of speakers expected in the audio file. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers) for more details.\n","type":"integer","default":10}}},"speakers_expected":{"x-label":"Speakers expected","description":"Tells the speaker label model how many speakers it should attempt to identify. See [Set number of speakers expected](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-number-of-speakers-expected) for more details.","type":"integer","default":null,"nullable":true},"speech_models":{"x-label":"Speech models","description":"List multiple speech models in priority order, allowing our system to automatically route your audio to the best available option. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models and routing behavior.\n","type":"array","items":{"x-label":"Speech model","type":"string","description":"The speech model to use for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","x-fern-sdk-group-name":"transcripts"}},"speech_threshold":{"x-label":"Speech threshold","description":"Reject audio files that contain less than this fraction of speech.\nValid values are in the range [0, 1] inclusive. See [Speech Threshold](https://www.assemblyai.com/docs/speech-threshold) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0,"nullable":true},"speech_understanding":{"x-label":"Speech Understanding","description":"Enable speech understanding tasks like [Translation](https://www.assemblyai.com/docs/speech-understanding/translation), [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification), and [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting). See the task-specific docs for available options and configuration.\n","type":"object","properties":{"request":{"oneOf":[{"x-label":"Translation request body","description":"Request body for [Translation](https://www.assemblyai.com/docs/speech-understanding/translation).","type":"object","properties":{"translation":{"type":"object","properties":{"target_languages":{"type":"array","items":{"type":"string"},"description":"List of target language codes (e.g., `[\"es\", \"de\"]`). See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for supported languages."},"formal":{"type":"boolean","description":"Use formal language style. See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for more details.","default":true},"match_original_utterance":{"type":"boolean","description":"When enabled with Speaker Labels, returns translated text in the utterances array. Each utterance will include a `translated_texts` key containing translations for each target language.","default":false}},"required":["target_languages"]}},"required":["translation"]},{"type":"object","description":"Request body for [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification).","properties":{"speaker_identification":{"type":"object","properties":{"speaker_type":{"type":"string","enum":["role","name"],"description":"Type of speaker identification. See [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification) for details on each type."},"known_values":{"type":"array","items":{"type":"string"},"description":"Required if speaker_type is \"role\". Each value must be 35 characters or less."},"speakers":{"type":"array","description":"An array of speaker objects with metadata to improve identification accuracy. Each object should include a `role` or `name` (depending on `speaker_type`) and an optional `description` to help the model identify the speaker. You can also include any additional custom properties (e.g., `company`, `title`) to provide more context. Use this as an alternative to `known_values` when you want to provide additional context about each speaker.","items":{"type":"object","properties":{"role":{"type":"string","description":"The role of the speaker. Required when `speaker_type` is \"role\"."},"name":{"type":"string","description":"The name of the speaker. Required when `speaker_type` is \"name\"."},"description":{"type":"string","description":"A description of the speaker to help the model identify them based on conversational context."}},"additionalProperties":true}}},"required":["speaker_type"]}},"required":["speaker_identification"]},{"type":"object","description":"Request body for [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting).","properties":{"custom_formatting":{"type":"object","properties":{"date":{"type":"string","description":"Date format pattern (e.g., `\"mm/dd/yyyy\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."},"phone_number":{"type":"string","description":"Phone number format pattern (e.g., `\"(xxx)xxx-xxxx\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."},"email":{"type":"string","description":"Email format pattern (e.g., `\"username@domain.com\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."}}}},"required":["custom_formatting"]}]}},"required":["request"]},"summarization":{"x-label":"Enable Summarization","description":"Enable [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization), can be true or false","type":"boolean","default":false},"summary_model":{"type":"string","x-label":"Summary model","description":"The model to summarize the transcript","x-fern-sdk-group-name":"transcripts","enum":["informative","conversational","catchy"],"x-aai-enum":{"informative":{"label":"Informative"},"conversational":{"label":"Conversational"},"catchy":{"label":"Catchy"}}},"summary_type":{"type":"string","x-label":"Summary type","description":"The type of summary","x-fern-sdk-group-name":"transcripts","enum":["bullets","bullets_verbose","gist","headline","paragraph"],"x-aai-enum":{"bullets":{"label":"Bullets"},"bullets_verbose":{"label":"Bullets verbose"},"gist":{"label":"Gist"},"headline":{"label":"Headline"},"paragraph":{"label":"Paragraph"}}},"temperature":{"x-label":"Temperature","description":"Control the amount of randomness injected into the model's response. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for more details.\n\nNote: This parameter can only be used with the Universal-3-Pro model.\n","type":"number","minimum":0,"maximum":1,"default":0},"custom_topics":{"x-label":"Enable custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"boolean","default":false,"deprecated":true},"speech_model":{"x-label":"Speech model","description":"This parameter has been replaced with the `speech_models` parameter, learn more about the `speech_models` parameter [here](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model).\n","oneOf":[{"x-label":"Speech model","type":"string","description":"The speech model to use for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","x-fern-sdk-group-name":"transcripts"},{"type":"string","nullable":true}],"deprecated":true},"topics":{"x-label":"Custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"array","items":{"x-label":"Topic","type":"string"},"deprecated":true}},"type":"object","additionalProperties":false,"x-label":"Optional transcript parameters","description":"Docs: https://www.assemblyai.com/docs/api-reference/transcripts/submit","x-fern-sdk-group-name":"transcripts","example":{"speech_model":null,"language_code":"en_us","language_detection":true,"language_confidence_threshold":0.7,"punctuate":true,"format_text":true,"multichannel":true,"webhook_url":"https://your-webhook-url.tld/path","webhook_auth_header_name":"webhook-secret","webhook_auth_header_value":"webhook-secret-value","auto_highlights":true,"audio_start_from":10,"audio_end_at":280,"filter_profanity":true,"redact_pii":true,"redact_pii_audio":true,"redact_pii_audio_quality":"mp3","redact_pii_policies":["us_social_security_number","credit_card_number"],"redact_pii_sub":"hash","speaker_labels":true,"speakers_expected":2,"content_safety":true,"iab_categories":true,"custom_spelling":[],"disfluencies":false,"sentiment_analysis":true,"auto_chapters":true,"entity_detection":true,"speech_threshold":0.5,"summarization":true,"summary_model":"informative","summary_type":"bullets","custom_topics":true,"topics":[],"speech_understanding":{"request":{"translation":{"target_languages":["es","de"],"formal":true,"match_original_utterance":true}}}},"title":"AssemblyAi async chunked transcription Settings"},"assembly_ai_v3_streaming":{"type":"object","properties":{"speech_model":{"description":"The speech model used for your Streaming session.","enum":["universal-streaming-english","universal-streaming-multilingual","whisper-rt","u3-rt-pro"]},"format_turns":{"description":"Whether to return formatted final transcripts.","default":false,"type":"boolean"},"inactivity_timeout":{"description":"Optional time in seconds of inactivity before session is terminated. If not set, no inactivity timeout is applied.","default":"None","format":"s","type":"integer","minimum":5,"maximum":3600},"keyterms_prompt":{"description":"A list of words and phrases to improve recognition accuracy for. See [Keyterms Prompting](https://www.assemblyai.com/docs/streaming/keyterms-prompting) for more details.","type":"array","items":{"x-label":"Word","type":"string"}},"language_detection":{"description":"Whether to detect the language and return language metadata on utterances and final turns. Only available for the multilingual model.","enum":["true","false"],"default":"false"},"max_turn_silence":{"description":"The maximum amount of silence in milliseconds allowed in a turn before end of turn is triggered. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","type":"integer","default":1280},"min_turn_silence":{"description":"The minimum amount of silence in milliseconds required to detect end of turn when confident. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","type":"integer","default":400},"vad_threshold":{"description":"The confidence threshold (0.0 to 1.0) for classifying audio frames as silence. Frames with VAD confidence below this value are considered silent. Increase for noisy environments to reduce false speech detection.","default":0.4,"type":"number"},"end_of_turn_confidence_threshold":{"description":"The confidence threshold (0.0 to 1.0) to use when determining if the end of a turn has been reached. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","deprecated":true,"type":"number","default":0.4},"language":{"description":"The language of your audio stream.","enum":["en","multi"],"default":"en","deprecated":true}},"title":"AssemblyAi Real-time Transcription Settings","description":"Docs: https://www.assemblyai.com/docs/api-reference/streaming-api/streaming-api"},"recallai_streaming":{"allOf":[{"$ref":"#/components/schemas/RecallaiStreamingTranscription"}],"title":"Recall.ai Real-time Transcription Settings","description":"Docs: https://docs.recall.ai/docs/recallai-transcription"},"deepgram_streaming":{"type":"object","properties":{"diarize":{"description":"Defaults to `false`. Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0","default":"false","enum":["true","false"]},"dictation":{"description":"Identify and extract key entities from content in submitted audio","default":"false","enum":["true","false"]},"endpointing":{"description":"Indicates how long Deepgram will wait to detect whether a speaker has finished speaking or pauses for a significant period of time. When set to a value, the streaming endpoint immediately finalizes the transcription for the processed time range and returns the transcript with a speech_final parameter set to true. Can also be set to false to disable endpointing","default":"10"},"extra":{"description":"Arbitrary key-value pairs that are attached to the API response for usage in downstream processing"},"filler_words":{"description":"Filler Words can help transcribe interruptions in your audio, like \"uh\" and \"um\"","default":"false","enum":["true","false"]},"interim_results":{"description":"Specifies whether the streaming endpoint should provide ongoing transcription updates as more audio is received. When set to true, the endpoint sends continuous updates, meaning transcription results may evolve over time","default":"false","enum":["true","false"]},"keyterm":{"description":"Key term prompting can boost or suppress specialized terminology and brands. Only compatible with Nova-3"},"keywords":{"description":"Keywords can boost or suppress specialized terminology and brands"},"language":{"description":"The [BCP-47 language tag](https://tools.ietf.org/html/bcp47) that hints at the primary spoken language. Depending on the Model you choose only certain languages are available","default":"en","enum":["bg","ca","cs","da","da-DK","de","de-CH","el","en","en-AU","en-GB","en-IN","en-NZ","en-US","es","es-419","es-LATAM","et","fi","fr","fr-CA","hi","hi-Latn","hu","id","it","ja","ko","ko-KR","lt","lv","ms","multi","nl","nl-BE","no","pl","pt","pt-BR","pt-PT","ro","ru","sk","sv","sv-SE","taq","th","th-TH","tr","uk","vi","zh","zh-CN","zh-HK","zh-Hans","zh-Hant","zh-TW"]},"mip_opt_out":{"description":"Opts out requests from the Deepgram Model Improvement Program. Refer to our Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mip","default":"false"},"model":{"description":"AI model to use for the transcription","enum":["nova-3","nova-3-general","nova-3-medical","nova-2","nova-2-general","nova-2-meeting","nova-2-finance","nova-2-conversationalai","nova-2-voicemail","nova-2-video","nova-2-medical","nova-2-drivethru","nova-2-automotive","nova","nova-general","nova-phonecall","nova-medical","enhanced","enhanced-general","enhanced-meeting","enhanced-phonecall","enhanced-finance","base","meeting","phonecall","finance","conversationalai","voicemail","video","custom"]},"multichannel":{"description":"Transcribe each audio channel independently","default":"false","enum":["true","false"]},"numerals":{"description":"Convert numbers from written format to numerical format","default":"false","enum":["true","false"]},"profanity_filter":{"description":"Profanity Filter looks for recognized profanity and converts it to the nearest recognized non-profane word or removes it from the transcript completely","default":"false","enum":["true","false"]},"punctuate":{"description":"Add punctuation and capitalization to the transcript","default":"false","enum":["true","false"]},"redact":{"description":"Redaction removes sensitive information from your transcripts","default":"false","enum":["true","false","pci","numbers","aggressive_numbers","ssn"]},"replace":{"description":"Search for terms or phrases in submitted audio and replaces them"},"search":{"description":"Search for terms or phrases in submitted audio"},"smart_format":{"description":"Apply formatting to transcript output. When set to true, additional formatting will be applied to transcripts to improve readability","default":"false","enum":["true","false"]},"tag":{"description":"Label your requests for the purpose of identification during usage reporting"},"utterance_end_ms":{"description":"Indicates how long Deepgram will wait to send an UtteranceEnd message after a word has been transcribed. Use with interim_results"},"vad_events":{"description":"Indicates that speech has started. You'll begin receiving Speech Started messages upon speech starting","default":"false","enum":["true","false"]},"version":{"description":"Version of an AI model to use","default":"latest"}},"title":"Deepgram Real-time Transcription Settings","description":"Docs: https://developers.deepgram.com/reference/streaming"},"gladia_v2_streaming":{"type":"object","properties":{"custom_metadata":{"type":"object","description":"Custom metadata you can attach to this live transcription","example":{"user":"John Doe"}},"model":{"type":"string","description":"The model used to process the audio. \"solaria-1\" is used by default.","default":"solaria-1","enum":["solaria-1"]},"endpointing":{"type":"number","description":"The endpointing duration in seconds. Endpointing is the duration of silence which will cause an utterance to be considered as finished","default":0.05,"minimum":0.01,"maximum":10},"maximum_duration_without_endpointing":{"type":"number","description":"The maximum duration in seconds without endpointing. If endpointing is not detected after this duration, current utterance will be considered as finished","default":5,"minimum":5,"maximum":60},"language_config":{"properties":{"languages":{"type":"array","description":"If one language is set, it will be used for the transcription. Otherwise, language will be auto-detected by the model.","default":[],"items":{"type":"string","enum":["af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","ca","zh","hr","cs","da","nl","en","et","fo","fi","fr","gl","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","id","it","ja","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","mymr","ne","no","nn","oc","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","jp"]}},"code_switching":{"type":"boolean","description":"If true, language will be auto-detected on each utterance. Otherwise, language will be auto-detected on first utterance and then used for the rest of the transcription. If one language is set, this option will be ignored.","default":false}},"type":"object","description":"Specify the language configuration"},"pre_processing":{"properties":{"audio_enhancer":{"type":"boolean","description":"If true, apply pre-processing to the audio stream to enhance the quality.","default":false},"speech_threshold":{"type":"number","description":"Sensitivity configuration for Speech Threshold. A value close to 1 will apply stricter thresholds, making it less likely to detect background sounds as speech.","default":0.6,"minimum":0,"maximum":1}},"type":"object","description":"Specify the pre-processing configuration"},"realtime_processing":{"properties":{"custom_vocabulary":{"type":"boolean","description":"If true, enable custom vocabulary for the transcription.","default":false},"custom_vocabulary_config":{"properties":{"vocabulary":{"description":"Specific vocabulary list to feed the transcription model with. Each item can be a string or an object with the following properties: value, intensity, pronunciations, language.","example":["Westeros",{"value":"Stark"},{"value":"Night's Watch","pronunciations":["Nightz Watch"],"intensity":0.4,"language":"en"}],"type":"array","items":{"oneOf":[{"type":"object","properties":{"value":{"type":"string","description":"The text used to replace in the transcription.","example":"Gladia"},"intensity":{"type":"number","description":"The global intensity of the feature.","example":0.5,"minimum":0,"maximum":1},"pronunciations":{"description":"The pronunciations used in the transcription.","type":"array","items":{"type":"string"}},"language":{"type":"string","description":"Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.","example":"en"}},"required":["value"]},{"type":"string"}]}},"default_intensity":{"type":"number","description":"Default intensity for the custom vocabulary","example":0.5,"minimum":0,"maximum":1}},"required":["vocabulary"],"type":"object","description":"Custom vocabulary configuration, if `custom_vocabulary` is enabled"},"custom_spelling":{"type":"boolean","description":"If true, enable custom spelling for the transcription.","default":false},"custom_spelling_config":{"properties":{"spelling_dictionary":{"type":"object","description":"The list of spelling applied on the audio transcription","example":{"Gettleman":["gettleman"],"SQL":["Sequel"]}}},"required":["spelling_dictionary"],"type":"object","description":"Custom spelling configuration, if `custom_spelling` is enabled"},"translation":{"type":"boolean","description":"If true, enable translation for the transcription","default":false},"translation_config":{"properties":{"target_languages":{"type":"array","example":["en"],"minItems":1,"items":{"type":"string","description":"The target language in `iso639-1` format","enum":["af","sq","am","ar","hy","as","ast","az","ba","eu","be","bn","bs","br","bg","my","ca","ceb","zh","hr","cs","da","nl","en","et","fo","fi","nl","fr","fy","ff","gd","gl","lg","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","ig","ilo","id","ga","it","ja","jp","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mo","mn","mymr","ne","no","nn","oc","or","pa","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","ss","sv","tl","tg","ta","tt","te","th","bo","tn","tr","tk","uk","ur","uz","vi","cy","wo","xh","yi","yo","zu"]}},"model":{"type":"string","description":"Model you want the translation model to use to translate","default":"base","enum":["base","enhanced"]},"match_original_utterances":{"type":"boolean","description":"Align translated utterances with the original ones","default":true},"lipsync":{"type":"boolean","description":"Whether to apply lipsync to the translated transcription. ","default":true},"context_adaptation":{"type":"boolean","description":"Enables or disables context-aware translation features that allow the model to adapt translations based on provided context.","default":true},"context":{"type":"string","description":"Context information to improve translation accuracy"},"informal":{"type":"boolean","description":"Forces the translation to use informal language forms when available in the target language.","default":false}},"required":["target_languages"],"type":"object","description":"Translation configuration, if `translation` is enabled"},"named_entity_recognition":{"type":"boolean","description":"If true, enable named entity recognition for the transcription.","default":false},"sentiment_analysis":{"type":"boolean","description":"If true, enable sentiment analysis for the transcription.","default":false}},"type":"object","description":"Specify the realtime processing configuration"},"post_processing":{"properties":{"summarization":{"type":"boolean","description":"If true, generates summarization for the whole transcription.","default":false},"summarization_config":{"properties":{"type":{"type":"string","description":"The type of summarization to apply","default":"general","enum":["general","bullet_points","concise"]}},"type":"object","description":"Summarization configuration, if `summarization` is enabled"},"chapterization":{"type":"boolean","description":"If true, generates chapters for the whole transcription.","default":false}},"type":"object","description":"Specify the post-processing configuration"},"messages_config":{"properties":{"receive_final_transcripts":{"type":"boolean","description":"If true, final utterance will be sent to websocket.","default":true},"receive_speech_events":{"type":"boolean","description":"If true, begin and end speech events will be sent to websocket.","default":true},"receive_pre_processing_events":{"type":"boolean","description":"If true, pre-processing events will be sent to websocket.","default":true},"receive_realtime_processing_events":{"type":"boolean","description":"If true, realtime processing events will be sent to websocket.","default":true},"receive_post_processing_events":{"type":"boolean","description":"If true, post-processing events will be sent to websocket.","default":true},"receive_acknowledgments":{"type":"boolean","description":"If true, acknowledgments will be sent to websocket.","default":true},"receive_errors":{"type":"boolean","description":"If true, errors will be sent to websocket.","default":true},"receive_lifecycle_events":{"type":"boolean","description":"If true, lifecycle events will be sent to websocket.","default":false}},"type":"object","description":"Specify the websocket messages configuration"},"callback":{"type":"boolean","description":"If true, messages will be sent to configured url.","default":false},"callback_config":{"properties":{"url":{"type":"string","description":"URL on which we will do a `POST` request with configured messages","example":"https://callback.example","format":"uri"},"receive_final_transcripts":{"type":"boolean","description":"If true, final utterance will be sent to the defined callback.","default":true},"receive_speech_events":{"type":"boolean","description":"If true, begin and end speech events will be sent to the defined callback.","default":false},"receive_pre_processing_events":{"type":"boolean","description":"If true, pre-processing events will be sent to the defined callback.","default":true},"receive_realtime_processing_events":{"type":"boolean","description":"If true, realtime processing events will be sent to the defined callback.","default":true},"receive_post_processing_events":{"type":"boolean","description":"If true, post-processing events will be sent to the defined callback.","default":true},"receive_acknowledgments":{"type":"boolean","description":"If true, acknowledgments will be sent to the defined callback.","default":false},"receive_errors":{"type":"boolean","description":"If true, errors will be sent to the defined callback.","default":false},"receive_lifecycle_events":{"type":"boolean","description":"If true, lifecycle events will be sent to the defined callback.","default":true}},"type":"object","description":"Specify the callback configuration"}},"title":"GladiaV2 Real-time Transcription Settings","description":"Docs: https://docs.gladia.io/api-reference/v2/live/init"},"rev_streaming":{"type":"object","properties":{"obscure_expletives":{"type":"boolean"},"delete_after":{"type":"string","format":"date-span"},"audio_options._content_type":{"type":"string"},"audio_options._layout":{"type":"string"},"audio_options._rate":{"type":"integer","format":"int32"},"audio_options._format":{"type":"string"},"audio_options._channels":{"type":"integer","format":"int32"},"transcriber":{"enum":[0,1],"type":"integer","format":"int32"},"language":{"type":"string"},"metadata":{"maxLength":512,"minLength":0,"type":"string"},"filter_profanity":{"type":"boolean"},"remove_disfluencies":{"type":"boolean"},"detailed_partials":{"type":"boolean"},"custom_vocabulary_id":{"type":"string"},"delete_after_seconds":{"type":"integer","format":"int32"},"max_segment_duration_seconds":{"maximum":30,"minimum":5,"type":"integer","format":"int32"},"max_connection_wait_seconds":{"maximum":600,"minimum":60,"type":"integer","format":"int32"},"allow_interruption":{"type":"boolean"},"enable_speaker_switch":{"type":"boolean"},"start_ts":{"type":"string","format":"date-span"},"skip_postprocessing":{"type":"boolean"},"priority":{"enum":[0,1],"type":"integer","format":"int32"},"user_agent":{"type":"string"}},"title":"Rev Real-time Transcription Settings","description":"Docs: https://docs.rev.ai/api/streaming/requests/"},"aws_transcribe_streaming":{"type":"object","description":"You must specify either:\n- `language_code`(e.g `en-US`) OR\n- Set `language_identification` to `true` AND specify `language_options`(e.g `en-US,fr-FR,es-US,de-DE,it-IT`).\n\nDocs: https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html","properties":{"language_code":{"type":"string","description":"Specify the language code that represents the language spoken. If you're unsure of the language spoken in your audio, consider using IdentifyLanguage to enable automatic language identification."},"vocabulary_filter_method":{"type":"string","description":"Specify how you want your vocabulary filter applied to your transcript. To replace words with ***, choose mask. To delete words, choose remove. To flag words without changing them, choose tag."},"vocabulary_filter_name":{"type":"string","description":"Specify the name of the custom vocabulary filter that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive.  If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region. If you include IdentifyLanguage and want to use one or more vocabulary filters with your transcription, use the VocabularyFilterNames parameter instead."},"vocabulary_name":{"type":"string","description":"Specify the name of the custom vocabulary that you want to use when processing your transcription. Note that vocabulary names are case sensitive. If you use Amazon Transcribe multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region. If you include IdentifyLanguage and want to use one or more custom vocabularies with your transcription, use the VocabularyNames parameter instead."},"region":{"type":"string","description":"The Amazon Web Services Region in which to use Amazon Transcribe. If you don't specify a Region, then the MediaRegion of the meeting is used. However, if Amazon Transcribe is not available in the MediaRegion, then a TranscriptFailed event is sent. Use auto to use Amazon Transcribe in a Region near the meeting’s MediaRegion. For more information, refer to Choosing a transcription Region in the Amazon Chime SDK Developer Guide."},"enable_partial_results_stabilization":{"type":"boolean","description":"Enables partial result stabilization for your transcription. Partial result stabilization can reduce latency in your output, but may impact accuracy."},"partial_results_stability":{"type":"string","description":"Specify the level of stability to use when you enable partial results stabilization (EnablePartialResultsStabilization). Low stability provides the highest accuracy. High stability transcribes faster, but with slightly lower accuracy."},"content_identification_type":{"type":"string","description":"Labels all personally identifiable information (PII) identified in your transcript. If you don't include PiiEntityTypes, all PII is identified.  You can’t set ContentIdentificationType and ContentRedactionType. "},"content_redaction_type":{"type":"string","description":"Content redaction is performed at the segment level. If you don't include PiiEntityTypes, all PII is redacted.  You can’t set ContentRedactionType and ContentIdentificationType. "},"pii_entity_types":{"type":"string","description":"Specify which types of personally identifiable information (PII) you want to redact in your transcript. You can include as many types as you'd like, or you can select ALL. Values must be comma-separated and can include: ADDRESS, BANK_ACCOUNT_NUMBER, BANK_ROUTING, CREDIT_DEBIT_CVV, CREDIT_DEBIT_EXPIRY CREDIT_DEBIT_NUMBER, EMAIL,NAME, PHONE, PIN, SSN, or ALL. Note that if you include PiiEntityTypes, you must also include ContentIdentificationType or ContentRedactionType. If you include ContentRedactionType or ContentIdentificationType, but do not include PiiEntityTypes, all PII is redacted or identified."},"language_model_name":{"type":"string","description":"Specify the name of the custom language model that you want to use when processing your transcription. Note that language model names are case sensitive. The language of the specified language model must match the language code. If the languages don't match, the custom language model isn't applied. There are no errors or warnings associated with a language mismatch. If you use Amazon Transcribe in multiple Regions, the custom language model must be available in Amazon Transcribe in each Region."},"identify_language":{"type":"boolean","description":"Enables automatic language identification for your transcription. If you include IdentifyLanguage, you can optionally use LanguageOptions to include a list of language codes that you think may be present in your audio stream. Including language options can improve transcription accuracy. You can also use PreferredLanguage to include a preferred language. Doing so can help Amazon Transcribe identify the language faster. You must include either LanguageCode or IdentifyLanguage. Language identification can't be combined with custom language models or redaction."},"language_options":{"type":"string","description":"Specify two or more language codes that represent the languages you think may be present in your media; including more than five is not recommended. If you're unsure what languages are present, do not include this parameter. Including language options can improve the accuracy of language identification. If you include LanguageOptions, you must also include IdentifyLanguage.  You can only include one language dialect per language. For example, you cannot include en-US and en-AU. "},"preferred_language":{"type":"string","description":"Specify a preferred language from the subset of languages codes you specified in LanguageOptions. You can only use this parameter if you include IdentifyLanguage and LanguageOptions."},"vocabulary_names":{"type":"string","description":"Specify the names of the custom vocabularies that you want to use when processing your transcription. Note that vocabulary names are case sensitive. If you use Amazon Transcribe in multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region. If you don't include IdentifyLanguage and want to use a custom vocabulary with your transcription, use the VocabularyName parameter instead."},"vocabulary_filter_names":{"type":"string","description":"Specify the names of the custom vocabulary filters that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive. If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region.  If you're not including IdentifyLanguage and want to use a custom vocabulary filter with your transcription, use the VocabularyFilterName parameter instead."}},"oneOf":[{"required":["language_code"]},{"required":["identify_language","language_options"],"properties":{"identify_language":{"type":"boolean","enum":[true]}}}],"title":"AWS Transcribe Streaming Transcription Settings"},"speechmatics_streaming":{"type":"object","properties":{"language":{"type":"string"},"domain":{"type":"string","description":"Request a specialized model based on 'language' but optimized for a particular field, e.g. \"finance\" or \"medical\"."},"output_locale":{"type":"string","minLength":1},"additional_vocab":{"type":"array","items":{"type":"object","oneOf":[{"type":"string","minLength":1},{"type":"object","properties":{"content":{"type":"string","minLength":1},"sounds_like":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["content"]}]}},"diarization":{"type":"string","enum":["none","speaker"]},"max_delay":{"type":"number","minimum":0},"max_delay_mode":{"type":"string","enum":["flexible","fixed"]},"speaker_diarization_config":{"type":"object","properties":{"max_speakers":{"type":"number","format":"integer","minimum":2,"maximum":100},"prefer_current_speaker":{"type":"boolean"},"speaker_sensitivity":{"type":"number","format":"float","minimum":0,"maximum":1}}},"audio_filtering_config":{"type":"object","properties":{"volume_threshold":{"type":"number","format":"float","minimum":0,"maximum":100}}},"transcript_filtering_config":{"type":"object","properties":{"remove_disfluencies":{"type":"boolean"},"replacements":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"]}}}},"enable_partials":{"type":"boolean","default":false},"enable_entities":{"type":"boolean","default":true},"operating_point":{"type":"string","enum":["standard","enhanced"]},"punctuation_overrides":{"type":"object","properties":{"permitted_marks":{"type":"array","description":"The punctuation marks which the client is prepared to accept in transcription output, or the special value 'all' (the default). Unsupported marks are ignored. This value is used to guide the transcription process.","items":{"pattern":"^(.|all)$","type":"string"}},"sensitivity":{"type":"number","description":"Ranges between zero and one. Higher values will produce more punctuation. The default is 0.5.","format":"float","maximum":1,"minimum":0}}},"conversation_config":{"type":"object","properties":{"end_of_utterance_silence_trigger":{"type":"number","format":"float","minimum":0,"maximum":2,"default":0}},"description":"This mode will detect when a speaker has stopped talking. The end_of_utterance_silence_trigger is the time in seconds after which the server will assume that the speaker has finished speaking, and will emit an EndOfUtterance message. A value of 0 disables the feature."}},"required":["language"],"title":"Speechmatics Real-time Transcription Settings","description":"You must specify `language` (e.g `en`)\n\nDocs: https://docs.speechmatics.com/rt-api-ref#transcription-config"},"elevenlabs_streaming":{"type":"object","properties":{"model_id":{"description":"The model to use for transcription.","type":"string","default":"eleven_whisper_v2_realtime"},"language_code":{"description":"ISO 639-1 two-letter language code. When not specified, the model auto-detects the language.","type":"string"},"previous_text":{"description":"Text from a previous transcription session to provide context for the model. Sent in the first message to the WebSocket.","type":"string"}},"title":"ElevenLabs Real-time Transcription Settings","description":"Docs: https://elevenlabs.io/docs/api-reference/speech-to-text"},"meeting_captions":{"type":"object","properties":{"language_code":{"enum":["cs","de","en","es","fil","fr","he","hi","it","ja","ko","nl","pl","pt","pt-BR","ro","ru","sv","th","tr","uk","vi","zh",null],"type":"string","description":"* `cs` - Czech\n* `de` - German\n* `en` - English\n* `es` - Spanish\n* `fil` - Filipino\n* `fr` - French\n* `he` - Hebrew\n* `hi` - Hindi\n* `it` - Italian\n* `ja` - Japanese\n* `ko` - Korean\n* `nl` - Dutch\n* `pl` - Polish\n* `pt` - Portuguese\n* `pt-BR` - Portuguese (Brazil)\n* `ro` - Romanian\n* `ru` - Russian\n* `sv` - Swedish\n* `th` - Thai\n* `tr` - Turkish\n* `uk` - Ukrainian\n* `vi` - Vietnamese\n* `zh` - Chinese","nullable":true,"title":"Language for captions. If not specified, the selection is meeting platform-specific."}}},"zoom_rtms":{"type":"object","title":"Zoom Real-Time Media Streams Transcription"}},"required":["assembly_ai_async","aws_transcribe_async","deepgram_async","elevenlabs_async","gladia_v2_async","google_speech_v2_async","recallai_async","rev_async","speechmatics_async"]},"TranscriptArtifactProviderRequest":{"type":"object","properties":{"assembly_ai_async_chunked":{"properties":{"audio_end_at":{"x-label":"Audio end at","description":"The point in time, in milliseconds, to stop transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer"},"audio_start_from":{"x-label":"Audio start from","description":"The point in time, in milliseconds, to begin transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer"},"auto_chapters":{"x-label":"Auto chapters","description":"Enable [Auto Chapters](https://www.assemblyai.com/docs/speech-understanding/auto-chapters), can be true or false","type":"boolean","default":false},"auto_highlights":{"x-label":"Key phrases","description":"Enable [Key Phrases](https://www.assemblyai.com/docs/speech-understanding/key-phrases), either true or false","type":"boolean","default":false},"content_safety":{"x-label":"Content Moderation","description":"Enable [Content Moderation](https://www.assemblyai.com/docs/content-moderation), can be true or false","type":"boolean","default":false},"content_safety_confidence":{"x-label":"Content Moderation confidence","description":"The confidence threshold for the [Content Moderation](https://www.assemblyai.com/docs/content-moderation) model. Values must be between 25 and 100.","type":"integer","default":50,"minimum":25,"maximum":100},"custom_spelling":{"x-label":"Custom spellings","description":"Customize how words are spelled and formatted using to and from values. See [Custom Spelling](https://www.assemblyai.com/docs/pre-recorded-audio/custom-spelling) for more details.","type":"array","items":{"x-label":"Custom spelling","description":"Object containing words or phrases to replace, and the word or phrase to replace with","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"from":{"x-label":"From","description":"Words or phrases to replace","type":"array","items":{"x-label":"Word or phrase","description":"Word or phrase to replace","type":"string"}},"to":{"x-label":"To","description":"Word to replace with","type":"string"}},"required":["from","to"],"example":{"from":["dicarlo"],"to":"Decarlo"}}},"disfluencies":{"x-label":"Disfluencies","description":"Transcribe [Filler Words](https://www.assemblyai.com/docs/pre-recorded-audio/filler-words), like \"umm\", in your media file; can be true or false","type":"boolean","default":false},"entity_detection":{"x-label":"Entity Detection","description":"Enable [Entity Detection](https://www.assemblyai.com/docs/speech-understanding/entity-detection), can be true or false","type":"boolean","default":false},"filter_profanity":{"x-label":"Filter profanity","description":"Filter profanity from the transcribed text, can be true or false. See [Profanity Filtering](https://www.assemblyai.com/docs/profanity-filtering) for more details.","type":"boolean","default":false},"format_text":{"x-label":"Format text","description":"Enable [Text Formatting](https://www.assemblyai.com/docs/pre-recorded-audio), can be true or false","type":"boolean","default":true},"iab_categories":{"x-label":"Topic Detection","description":"Enable [Topic Detection](https://www.assemblyai.com/docs/speech-understanding/topic-detection), can be true or false","type":"boolean","default":false},"keyterms_prompt":{"x-label":"Keyterms prompt","description":"Improve accuracy with up to 200 (for Universal-2) or 1000 (for Universal-3-Pro) domain-specific words or phrases (maximum 6 words per phrase). See [Keyterms Prompting](https://www.assemblyai.com/docs/pre-recorded-audio/keyterms-prompting) for more details.\n","type":"array","items":{"x-label":"Keyterm","type":"string"}},"language_code":{"x-label":"Language code","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","oneOf":[{"anyOf":[{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"}}},{"type":"string"}]},{"type":"string","nullable":true}],"default":"en_us","x-ts-type":"LiteralUnion<TranscriptLanguageCode, string> | null","x-go-type":"TranscriptLanguageCode"},"language_codes":{"description":"The language codes of your audio file. Used for [Code switching](/docs/speech-to-text/pre-recorded-audio/code-switching)\nOne of the values specified must be `en`.\n","type":"array","items":{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nThe default value is 'en_us'.\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"}}},"nullable":true},"language_confidence_threshold":{"x-label":"Language confidence threshold","description":"The confidence threshold for the automatically detected language.\nAn error will be returned if the language confidence is below this threshold.\nDefaults to 0. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0},"language_detection":{"x-label":"Language detection","description":"Enable [Automatic language detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection), either true or false.","type":"boolean","default":false},"language_detection_options":{"x-label":"Specify options for Automatic Language Detection.","description":"Specify options for [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection).","type":"object","additionalProperties":false,"properties":{"expected_languages":{"x-label":"Expected languages","description":"List of languages expected in the audio file. Defaults to `[\"all\"]` when unspecified. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.","type":"array","items":{"x-label":"language","type":"string"}},"fallback_language":{"x-label":"Fallback language","description":"If the detected language of the audio file is not in the list of expected languages, the `fallback_language` is used. Specify `[\"auto\"]` to let our model choose the fallback language from `expected_languages` with the highest confidence score. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"string","default":"auto"},"code_switching":{"x-label":"Code switching","description":"Whether [code switching](/docs/speech-to-text/pre-recorded-audio/code-switching) should be detected.\n","type":"boolean","default":false},"code_switching_confidence_threshold":{"x-label":"Code switching confidence threshold","description":"The confidence threshold for [code switching](/docs/speech-to-text/pre-recorded-audio/code-switching) detection. If the code switching confidence is below this threshold, the transcript will be processed in the language with the highest `language_detection_confidence` score.\n","type":"number","minimum":0,"maximum":1,"default":0.3}}},"multichannel":{"x-label":"Multichannel","description":"Enable [Multichannel](https://www.assemblyai.com/docs/pre-recorded-audio/multichannel) transcription, can be true or false.","type":"boolean","default":false},"prompt":{"x-label":"Prompt","description":"Provide natural language prompting of up to 1,500 words of contextual information to the model. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for best practices.\n\nNote: This parameter is only supported for the Universal-3-Pro model.\n","type":"string"},"punctuate":{"x-label":"Punctuate","description":"Enable [Automatic Punctuation](https://www.assemblyai.com/docs/pre-recorded-audio), can be true or false","type":"boolean","default":true},"redact_pii":{"x-label":"Redact PII","description":"Redact PII from the transcribed text using the Redact PII model, can be true or false. See [PII Redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"boolean","default":false},"redact_pii_audio":{"x-label":"Redact PII audio","description":"Generate a copy of the original media file with spoken PII \"beeped\" out, can be true or false. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","type":"boolean","default":false},"redact_pii_audio_options":{"x-label":"Specify options for PII redacted audio files.","description":"Specify options for [PII redacted audio](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) files.","type":"object","additionalProperties":false,"properties":{"return_redacted_no_speech_audio":{"x-label":"Return redacted no speech audio","description":"By default, audio redaction provides redacted audio URLs only when speech is detected. However, if your use-case specifically requires redacted audio files even for silent audio files without any dialogue, you can opt to receive these URLs by setting this parameter to `true`.","type":"boolean","default":false}}},"redact_pii_audio_quality":{"x-label":"Redact PII audio quality","type":"string","description":"Controls the filetype of the audio created by redact_pii_audio. Currently supports mp3 (default) and wav. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","x-fern-sdk-group-name":"transcripts","enum":["mp3","wav"],"x-fern-enum":{"mp3":{"description":"MP3 audio format is lower quality and lower size than WAV.","casing":{"camel":"mp3","snake":"mp3","pascal":"Mp3","screamingSnake":"MP3"}},"wav":{"description":"WAV audio format is the highest quality (no compression) and larger size than MP3."}},"x-aai-enum":{"mp3":{"label":"MP3"},"wav":{"label":"WAV"}},"example":"mp3"},"redact_pii_policies":{"x-label":"Redact PII policies","description":"The list of PII Redaction policies to enable. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"array","items":{"x-label":"PII policy","description":"The type of PII to redact","x-fern-sdk-group-name":"transcripts","type":"string","enum":["account_number","banking_information","blood_type","credit_card_cvv","credit_card_expiration","credit_card_number","date","date_interval","date_of_birth","drivers_license","drug","duration","email_address","event","filename","gender_sexuality","healthcare_number","injury","ip_address","language","location","marital_status","medical_condition","medical_process","money_amount","nationality","number_sequence","occupation","organization","passport_number","password","person_age","person_name","phone_number","physical_attribute","political_affiliation","religion","statistics","time","url","us_social_security_number","username","vehicle_id","zodiac_sign"],"x-fern-enum":{"account_number":{"description":"Customer account or membership identification number (e.g., Policy No. 10042992, Member ID: HZ-5235-001)"},"banking_information":{"description":"Banking information, including account and routing numbers"},"blood_type":{"description":"Blood type (e.g., O-, AB positive)"},"credit_card_cvv":{"description":"Credit card verification code (e.g., CVV: 080)"},"credit_card_expiration":{"description":"Expiration date of a credit card"},"credit_card_number":{"description":"Credit card number"},"date":{"description":"Specific calendar date (e.g., December 18)"},"date_interval":{"description":"Broader time periods, including date ranges, months, seasons, years, and decades (e.g., 2020-2021, 5-9 May, January 1984)"},"date_of_birth":{"description":"Date of birth (e.g., Date of Birth: March 7,1961)"},"drivers_license":{"description":"Driver's license number. (e.g., DL# 356933-540)"},"drug":{"description":"Medications, vitamins, or supplements (e.g., Advil, Acetaminophen, Panadol)"},"duration":{"description":"Periods of time, specified as a number and a unit of time (e.g., 8 months, 2 years)"},"email_address":{"description":"Email address (e.g., support@assemblyai.com)"},"event":{"description":"Name of an event or holiday (e.g., Olympics, Yom Kippur)"},"filename":{"description":"Names of computer files, including the extension or filepath (e.g., Taxes/2012/brad-tax-returns.pdf)"},"gender_sexuality":{"description":"Terms indicating gender identity or sexual orientation, including slang terms (e.g., female, bisexual, trans)"},"healthcare_number":{"description":"Healthcare numbers and health plan beneficiary numbers (e.g., Policy No.: 5584-486-674-YM)"},"injury":{"description":"Bodily injury (e.g., I broke my arm, I have a sprained wrist)"},"ip_address":{"description":"Internet IP address, including IPv4 and IPv6 formats (e.g., 192.168.0.1)"},"language":{"description":"Name of a natural language (e.g., Spanish, French)"},"location":{"description":"Any Location reference including mailing address, postal code, city, state, province, country, or coordinates. (e.g., Lake Victoria, 145 Windsor St., 90210)"},"marital_status":{"description":"Terms indicating marital status (e.g., Single, common-law, ex-wife, married)"},"medical_condition":{"description":"Name of a medical condition, disease, syndrome, deficit, or disorder (e.g., chronic fatigue syndrome, arrhythmia, depression)"},"medical_process":{"description":"Medical process, including treatments, procedures, and tests (e.g., heart surgery, CT scan)"},"money_amount":{"description":"Name and/or amount of currency (e.g., 15 pesos, $94.50)"},"nationality":{"description":"Terms indicating nationality, ethnicity, or race (e.g., American, Asian, Caucasian)"},"number_sequence":{"description":"Numerical PII (including alphanumeric strings) that doesn't fall under other categories"},"occupation":{"description":"Job title or profession (e.g., professor, actors, engineer, CPA)"},"organization":{"description":"Name of an organization (e.g., CNN, McDonalds, University of Alaska, Northwest General Hospital)"},"passport_number":{"description":"Passport numbers, issued by any country (e.g., PA4568332, NU3C6L86S12)"},"password":{"description":"Account passwords, PINs, access keys, or verification answers (e.g., 27%alfalfa, temp1234, My mother's maiden name is Smith)"},"person_age":{"description":"Number associated with an age (e.g., 27, 75)"},"person_name":{"description":"Name of a person (e.g., Bob, Doug Jones, Dr. Kay Martinez, MD)"},"phone_number":{"description":"Telephone or fax number"},"physical_attribute":{"description":"Distinctive bodily attributes, including terms indicating race (e.g., I'm 190cm tall, He belongs to the Black students' association)"},"political_affiliation":{"description":"Terms referring to a political party, movement, or ideology (e.g., Republican, Liberal)"},"religion":{"description":"Terms indicating religious affiliation (e.g., Hindu, Catholic)"},"statistics":{"description":"Medical statistics (e.g., 18%, 18 percent)"},"time":{"description":"Expressions indicating clock times (e.g., 19:37:28, 10pm EST)"},"url":{"description":"Internet addresses (e.g., https://www.assemblyai.com/)"},"us_social_security_number":{"description":"Social Security Number or equivalent"},"username":{"description":"Usernames, login names, or handles (e.g., @AssemblyAI)"},"vehicle_id":{"description":"Vehicle identification numbers (VINs), vehicle serial numbers, and license plate numbers (e.g., 5FNRL38918B111818, BIF7547)"},"zodiac_sign":{"description":"Names of Zodiac signs (e.g., Aries, Taurus)"}},"x-aai-enum":{"account_number":{"label":"Account number"},"banking_information":{"label":"Banking information"},"blood_type":{"label":"Blood type"},"credit_card_cvv":{"label":"Credit card CVV"},"credit_card_expiration":{"label":"Credit card expiration"},"credit_card_number":{"label":"Credit card number"},"date":{"label":"Date"},"date_interval":{"label":"Date interval"},"date_of_birth":{"label":"Date of birth"},"drivers_license":{"label":"Driver's license"},"drug":{"label":"Drug"},"duration":{"label":"Duration"},"email_address":{"label":"Email address"},"event":{"label":"Event"},"filename":{"label":"Filename"},"gender_sexuality":{"label":"Gender sexuality"},"healthcare_number":{"label":"Healthcare number"},"injury":{"label":"Injury"},"ip_address":{"label":"IP address"},"language":{"label":"Language"},"location":{"label":"Location"},"marital_status":{"label":"Marital status"},"medical_condition":{"label":"Medical condition"},"medical_process":{"label":"Medical process"},"money_amount":{"label":"Money amount"},"nationality":{"label":"Nationality"},"number_sequence":{"label":"Number sequence"},"occupation":{"label":"Occupation"},"organization":{"label":"Organization"},"passport_number":{"label":"Passport number"},"password":{"label":"Password"},"person_age":{"label":"Person age"},"person_name":{"label":"Person name"},"phone_number":{"label":"Phone number"},"physical_attribute":{"label":"Physical attribute"},"political_affiliation":{"label":"Political affiliation"},"religion":{"label":"Religion"},"statistics":{"label":"Statistics"},"time":{"label":"Time"},"url":{"label":"URL"},"us_social_security_number":{"label":"US Social Security Number"},"username":{"label":"Username"},"vehicle_id":{"label":"Vehicle ID"},"zodiac_sign":{"label":"Zodiac sign"}}}},"redact_pii_sub":{"x-label":"Redact PII substitution","description":"The replacement logic for detected PII, can be `entity_type` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","oneOf":[{"x-label":"Redact PII substitution","type":"string","x-fern-sdk-group-name":"transcripts","description":"The replacement logic for detected PII, can be `entity_name` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","enum":["entity_name","hash"],"x-aai-enum":{"entity_name":{"label":"Entity name"},"hash":{"label":"Hash"}}},{"type":"string","nullable":true}],"default":"hash"},"sentiment_analysis":{"x-label":"Sentiment Analysis","description":"Enable [Sentiment Analysis](https://www.assemblyai.com/docs/speech-understanding/sentiment-analysis), can be true or false","type":"boolean","default":false},"speaker_labels":{"x-label":"Speaker labels","description":"Enable [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization), can be true or false","type":"boolean","default":false},"speaker_options":{"x-label":"Specify options for speaker diarization.","description":"Specify options for [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers). Use this to set a range of possible speakers.","type":"object","additionalProperties":false,"properties":{"min_speakers_expected":{"x-label":"Minimum speakers expected","description":"The minimum number of speakers expected in the audio file. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers) for more details.","type":"integer","default":1},"max_speakers_expected":{"x-label":"Maximum speakers expected","description":"<Warning>Setting this parameter too high may hurt model accuracy</Warning>\nThe maximum number of speakers expected in the audio file. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-a-range-of-possible-speakers) for more details.\n","type":"integer","default":10}}},"speakers_expected":{"x-label":"Speakers expected","description":"Tells the speaker label model how many speakers it should attempt to identify. See [Set number of speakers expected](https://www.assemblyai.com/docs/pre-recorded-audio/speaker-diarization#set-number-of-speakers-expected) for more details.","type":"integer","default":null,"nullable":true},"speech_models":{"x-label":"Speech models","description":"List multiple speech models in priority order, allowing our system to automatically route your audio to the best available option. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models and routing behavior.\n","type":"array","items":{"x-label":"Speech model","type":"string","description":"The speech model to use for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","x-fern-sdk-group-name":"transcripts"}},"speech_threshold":{"x-label":"Speech threshold","description":"Reject audio files that contain less than this fraction of speech.\nValid values are in the range [0, 1] inclusive. See [Speech Threshold](https://www.assemblyai.com/docs/speech-threshold) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0,"nullable":true},"speech_understanding":{"x-label":"Speech Understanding","description":"Enable speech understanding tasks like [Translation](https://www.assemblyai.com/docs/speech-understanding/translation), [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification), and [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting). See the task-specific docs for available options and configuration.\n","type":"object","properties":{"request":{"oneOf":[{"x-label":"Translation request body","description":"Request body for [Translation](https://www.assemblyai.com/docs/speech-understanding/translation).","type":"object","properties":{"translation":{"type":"object","properties":{"target_languages":{"type":"array","items":{"type":"string"},"description":"List of target language codes (e.g., `[\"es\", \"de\"]`). See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for supported languages."},"formal":{"type":"boolean","description":"Use formal language style. See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for more details.","default":true},"match_original_utterance":{"type":"boolean","description":"When enabled with Speaker Labels, returns translated text in the utterances array. Each utterance will include a `translated_texts` key containing translations for each target language.","default":false}},"required":["target_languages"]}},"required":["translation"]},{"type":"object","description":"Request body for [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification).","properties":{"speaker_identification":{"type":"object","properties":{"speaker_type":{"type":"string","enum":["role","name"],"description":"Type of speaker identification. See [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification) for details on each type."},"known_values":{"type":"array","items":{"type":"string"},"description":"Required if speaker_type is \"role\". Each value must be 35 characters or less."},"speakers":{"type":"array","description":"An array of speaker objects with metadata to improve identification accuracy. Each object should include a `role` or `name` (depending on `speaker_type`) and an optional `description` to help the model identify the speaker. You can also include any additional custom properties (e.g., `company`, `title`) to provide more context. Use this as an alternative to `known_values` when you want to provide additional context about each speaker.","items":{"type":"object","properties":{"role":{"type":"string","description":"The role of the speaker. Required when `speaker_type` is \"role\"."},"name":{"type":"string","description":"The name of the speaker. Required when `speaker_type` is \"name\"."},"description":{"type":"string","description":"A description of the speaker to help the model identify them based on conversational context."}},"additionalProperties":true}}},"required":["speaker_type"]}},"required":["speaker_identification"]},{"type":"object","description":"Request body for [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting).","properties":{"custom_formatting":{"type":"object","properties":{"date":{"type":"string","description":"Date format pattern (e.g., `\"mm/dd/yyyy\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."},"phone_number":{"type":"string","description":"Phone number format pattern (e.g., `\"(xxx)xxx-xxxx\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."},"email":{"type":"string","description":"Email format pattern (e.g., `\"username@domain.com\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details."}}}},"required":["custom_formatting"]}]}},"required":["request"]},"summarization":{"x-label":"Enable Summarization","description":"Enable [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization), can be true or false","type":"boolean","default":false},"summary_model":{"type":"string","x-label":"Summary model","description":"The model to summarize the transcript","x-fern-sdk-group-name":"transcripts","enum":["informative","conversational","catchy"],"x-aai-enum":{"informative":{"label":"Informative"},"conversational":{"label":"Conversational"},"catchy":{"label":"Catchy"}}},"summary_type":{"type":"string","x-label":"Summary type","description":"The type of summary","x-fern-sdk-group-name":"transcripts","enum":["bullets","bullets_verbose","gist","headline","paragraph"],"x-aai-enum":{"bullets":{"label":"Bullets"},"bullets_verbose":{"label":"Bullets verbose"},"gist":{"label":"Gist"},"headline":{"label":"Headline"},"paragraph":{"label":"Paragraph"}}},"temperature":{"x-label":"Temperature","description":"Control the amount of randomness injected into the model's response. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for more details.\n\nNote: This parameter can only be used with the Universal-3-Pro model.\n","type":"number","minimum":0,"maximum":1,"default":0},"custom_topics":{"x-label":"Enable custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"boolean","default":false,"deprecated":true},"speech_model":{"x-label":"Speech model","description":"This parameter has been replaced with the `speech_models` parameter, learn more about the `speech_models` parameter [here](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model).\n","oneOf":[{"x-label":"Speech model","type":"string","description":"The speech model to use for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","x-fern-sdk-group-name":"transcripts"},{"type":"string","nullable":true}],"deprecated":true},"topics":{"x-label":"Custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"array","items":{"x-label":"Topic","type":"string"},"deprecated":true}},"type":"object","additionalProperties":false,"x-label":"Optional transcript parameters","description":"Docs: https://www.assemblyai.com/docs/api-reference/transcripts/submit","x-fern-sdk-group-name":"transcripts","example":{"speech_model":null,"language_code":"en_us","language_detection":true,"language_confidence_threshold":0.7,"punctuate":true,"format_text":true,"multichannel":true,"webhook_url":"https://your-webhook-url.tld/path","webhook_auth_header_name":"webhook-secret","webhook_auth_header_value":"webhook-secret-value","auto_highlights":true,"audio_start_from":10,"audio_end_at":280,"filter_profanity":true,"redact_pii":true,"redact_pii_audio":true,"redact_pii_audio_quality":"mp3","redact_pii_policies":["us_social_security_number","credit_card_number"],"redact_pii_sub":"hash","speaker_labels":true,"speakers_expected":2,"content_safety":true,"iab_categories":true,"custom_spelling":[],"disfluencies":false,"sentiment_analysis":true,"auto_chapters":true,"entity_detection":true,"speech_threshold":0.5,"summarization":true,"summary_model":"informative","summary_type":"bullets","custom_topics":true,"topics":[],"speech_understanding":{"request":{"translation":{"target_languages":["es","de"],"formal":true,"match_original_utterance":true}}}},"title":"AssemblyAi async chunked transcription Settings"},"assembly_ai_v3_streaming":{"type":"object","properties":{"speech_model":{"description":"The speech model used for your Streaming session.","enum":["universal-streaming-english","universal-streaming-multilingual","whisper-rt","u3-rt-pro"]},"format_turns":{"description":"Whether to return formatted final transcripts.","default":false,"type":"boolean"},"inactivity_timeout":{"description":"Optional time in seconds of inactivity before session is terminated. If not set, no inactivity timeout is applied.","default":"None","format":"s","type":"integer","minimum":5,"maximum":3600},"keyterms_prompt":{"description":"A list of words and phrases to improve recognition accuracy for. See [Keyterms Prompting](https://www.assemblyai.com/docs/streaming/keyterms-prompting) for more details.","type":"array","items":{"x-label":"Word","type":"string"}},"language_detection":{"description":"Whether to detect the language and return language metadata on utterances and final turns. Only available for the multilingual model.","enum":["true","false"],"default":"false"},"max_turn_silence":{"description":"The maximum amount of silence in milliseconds allowed in a turn before end of turn is triggered. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","type":"integer","default":1280},"min_turn_silence":{"description":"The minimum amount of silence in milliseconds required to detect end of turn when confident. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","type":"integer","default":400},"vad_threshold":{"description":"The confidence threshold (0.0 to 1.0) for classifying audio frames as silence. Frames with VAD confidence below this value are considered silent. Increase for noisy environments to reduce false speech detection.","default":0.4,"type":"number"},"end_of_turn_confidence_threshold":{"description":"The confidence threshold (0.0 to 1.0) to use when determining if the end of a turn has been reached. See [Turn Detection](https://www.assemblyai.com/docs/streaming/universal-streaming/turn-detection) for configuration details.","deprecated":true,"type":"number","default":0.4},"language":{"description":"The language of your audio stream.","enum":["en","multi"],"default":"en","deprecated":true}},"title":"AssemblyAi Real-time Transcription Settings","description":"Docs: https://www.assemblyai.com/docs/api-reference/streaming-api/streaming-api"},"recallai_streaming":{"allOf":[{"$ref":"#/components/schemas/RecallaiStreamingTranscriptionRequest"}],"title":"Recall.ai Real-time Transcription Settings","description":"Docs: https://docs.recall.ai/docs/recallai-transcription"},"deepgram_streaming":{"type":"object","properties":{"diarize":{"description":"Defaults to `false`. Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0","default":"false","enum":["true","false"]},"dictation":{"description":"Identify and extract key entities from content in submitted audio","default":"false","enum":["true","false"]},"endpointing":{"description":"Indicates how long Deepgram will wait to detect whether a speaker has finished speaking or pauses for a significant period of time. When set to a value, the streaming endpoint immediately finalizes the transcription for the processed time range and returns the transcript with a speech_final parameter set to true. Can also be set to false to disable endpointing","default":"10"},"extra":{"description":"Arbitrary key-value pairs that are attached to the API response for usage in downstream processing"},"filler_words":{"description":"Filler Words can help transcribe interruptions in your audio, like \"uh\" and \"um\"","default":"false","enum":["true","false"]},"interim_results":{"description":"Specifies whether the streaming endpoint should provide ongoing transcription updates as more audio is received. When set to true, the endpoint sends continuous updates, meaning transcription results may evolve over time","default":"false","enum":["true","false"]},"keyterm":{"description":"Key term prompting can boost or suppress specialized terminology and brands. Only compatible with Nova-3"},"keywords":{"description":"Keywords can boost or suppress specialized terminology and brands"},"language":{"description":"The [BCP-47 language tag](https://tools.ietf.org/html/bcp47) that hints at the primary spoken language. Depending on the Model you choose only certain languages are available","default":"en","enum":["bg","ca","cs","da","da-DK","de","de-CH","el","en","en-AU","en-GB","en-IN","en-NZ","en-US","es","es-419","es-LATAM","et","fi","fr","fr-CA","hi","hi-Latn","hu","id","it","ja","ko","ko-KR","lt","lv","ms","multi","nl","nl-BE","no","pl","pt","pt-BR","pt-PT","ro","ru","sk","sv","sv-SE","taq","th","th-TH","tr","uk","vi","zh","zh-CN","zh-HK","zh-Hans","zh-Hant","zh-TW"]},"mip_opt_out":{"description":"Opts out requests from the Deepgram Model Improvement Program. Refer to our Docs for pricing impacts before setting this to true. https://dpgr.am/deepgram-mip","default":"false"},"model":{"description":"AI model to use for the transcription","enum":["nova-3","nova-3-general","nova-3-medical","nova-2","nova-2-general","nova-2-meeting","nova-2-finance","nova-2-conversationalai","nova-2-voicemail","nova-2-video","nova-2-medical","nova-2-drivethru","nova-2-automotive","nova","nova-general","nova-phonecall","nova-medical","enhanced","enhanced-general","enhanced-meeting","enhanced-phonecall","enhanced-finance","base","meeting","phonecall","finance","conversationalai","voicemail","video","custom"]},"multichannel":{"description":"Transcribe each audio channel independently","default":"false","enum":["true","false"]},"numerals":{"description":"Convert numbers from written format to numerical format","default":"false","enum":["true","false"]},"profanity_filter":{"description":"Profanity Filter looks for recognized profanity and converts it to the nearest recognized non-profane word or removes it from the transcript completely","default":"false","enum":["true","false"]},"punctuate":{"description":"Add punctuation and capitalization to the transcript","default":"false","enum":["true","false"]},"redact":{"description":"Redaction removes sensitive information from your transcripts","default":"false","enum":["true","false","pci","numbers","aggressive_numbers","ssn"]},"replace":{"description":"Search for terms or phrases in submitted audio and replaces them"},"search":{"description":"Search for terms or phrases in submitted audio"},"smart_format":{"description":"Apply formatting to transcript output. When set to true, additional formatting will be applied to transcripts to improve readability","default":"false","enum":["true","false"]},"tag":{"description":"Label your requests for the purpose of identification during usage reporting"},"utterance_end_ms":{"description":"Indicates how long Deepgram will wait to send an UtteranceEnd message after a word has been transcribed. Use with interim_results"},"vad_events":{"description":"Indicates that speech has started. You'll begin receiving Speech Started messages upon speech starting","default":"false","enum":["true","false"]},"version":{"description":"Version of an AI model to use","default":"latest"}},"title":"Deepgram Real-time Transcription Settings","description":"Docs: https://developers.deepgram.com/reference/streaming"},"gladia_v2_streaming":{"type":"object","properties":{"custom_metadata":{"type":"object","description":"Custom metadata you can attach to this live transcription","example":{"user":"John Doe"}},"model":{"type":"string","description":"The model used to process the audio. \"solaria-1\" is used by default.","default":"solaria-1","enum":["solaria-1"]},"endpointing":{"type":"number","description":"The endpointing duration in seconds. Endpointing is the duration of silence which will cause an utterance to be considered as finished","default":0.05,"minimum":0.01,"maximum":10},"maximum_duration_without_endpointing":{"type":"number","description":"The maximum duration in seconds without endpointing. If endpointing is not detected after this duration, current utterance will be considered as finished","default":5,"minimum":5,"maximum":60},"language_config":{"properties":{"languages":{"type":"array","description":"If one language is set, it will be used for the transcription. Otherwise, language will be auto-detected by the model.","default":[],"items":{"type":"string","enum":["af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","ca","zh","hr","cs","da","nl","en","et","fo","fi","fr","gl","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","id","it","ja","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","mymr","ne","no","nn","oc","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","jp"]}},"code_switching":{"type":"boolean","description":"If true, language will be auto-detected on each utterance. Otherwise, language will be auto-detected on first utterance and then used for the rest of the transcription. If one language is set, this option will be ignored.","default":false}},"type":"object","description":"Specify the language configuration"},"pre_processing":{"properties":{"audio_enhancer":{"type":"boolean","description":"If true, apply pre-processing to the audio stream to enhance the quality.","default":false},"speech_threshold":{"type":"number","description":"Sensitivity configuration for Speech Threshold. A value close to 1 will apply stricter thresholds, making it less likely to detect background sounds as speech.","default":0.6,"minimum":0,"maximum":1}},"type":"object","description":"Specify the pre-processing configuration"},"realtime_processing":{"properties":{"custom_vocabulary":{"type":"boolean","description":"If true, enable custom vocabulary for the transcription.","default":false},"custom_vocabulary_config":{"properties":{"vocabulary":{"description":"Specific vocabulary list to feed the transcription model with. Each item can be a string or an object with the following properties: value, intensity, pronunciations, language.","example":["Westeros",{"value":"Stark"},{"value":"Night's Watch","pronunciations":["Nightz Watch"],"intensity":0.4,"language":"en"}],"type":"array","items":{"oneOf":[{"type":"object","properties":{"value":{"type":"string","description":"The text used to replace in the transcription.","example":"Gladia"},"intensity":{"type":"number","description":"The global intensity of the feature.","example":0.5,"minimum":0,"maximum":1},"pronunciations":{"description":"The pronunciations used in the transcription.","type":"array","items":{"type":"string"}},"language":{"type":"string","description":"Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.","example":"en"}},"required":["value"]},{"type":"string"}]}},"default_intensity":{"type":"number","description":"Default intensity for the custom vocabulary","example":0.5,"minimum":0,"maximum":1}},"required":["vocabulary"],"type":"object","description":"Custom vocabulary configuration, if `custom_vocabulary` is enabled"},"custom_spelling":{"type":"boolean","description":"If true, enable custom spelling for the transcription.","default":false},"custom_spelling_config":{"properties":{"spelling_dictionary":{"type":"object","description":"The list of spelling applied on the audio transcription","example":{"Gettleman":["gettleman"],"SQL":["Sequel"]}}},"required":["spelling_dictionary"],"type":"object","description":"Custom spelling configuration, if `custom_spelling` is enabled"},"translation":{"type":"boolean","description":"If true, enable translation for the transcription","default":false},"translation_config":{"properties":{"target_languages":{"type":"array","example":["en"],"minItems":1,"items":{"type":"string","description":"The target language in `iso639-1` format","enum":["af","sq","am","ar","hy","as","ast","az","ba","eu","be","bn","bs","br","bg","my","ca","ceb","zh","hr","cs","da","nl","en","et","fo","fi","nl","fr","fy","ff","gd","gl","lg","ka","de","el","gu","ht","ha","haw","he","hi","hu","is","ig","ilo","id","ga","it","ja","jp","jv","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mo","mn","mymr","ne","no","nn","oc","or","pa","ps","fa","pl","pt","pa","ro","ru","sa","sr","sn","sd","si","sk","sl","so","es","su","sw","ss","sv","tl","tg","ta","tt","te","th","bo","tn","tr","tk","uk","ur","uz","vi","cy","wo","xh","yi","yo","zu"]}},"model":{"type":"string","description":"Model you want the translation model to use to translate","default":"base","enum":["base","enhanced"]},"match_original_utterances":{"type":"boolean","description":"Align translated utterances with the original ones","default":true},"lipsync":{"type":"boolean","description":"Whether to apply lipsync to the translated transcription. ","default":true},"context_adaptation":{"type":"boolean","description":"Enables or disables context-aware translation features that allow the model to adapt translations based on provided context.","default":true},"context":{"type":"string","description":"Context information to improve translation accuracy"},"informal":{"type":"boolean","description":"Forces the translation to use informal language forms when available in the target language.","default":false}},"required":["target_languages"],"type":"object","description":"Translation configuration, if `translation` is enabled"},"named_entity_recognition":{"type":"boolean","description":"If true, enable named entity recognition for the transcription.","default":false},"sentiment_analysis":{"type":"boolean","description":"If true, enable sentiment analysis for the transcription.","default":false}},"type":"object","description":"Specify the realtime processing configuration"},"post_processing":{"properties":{"summarization":{"type":"boolean","description":"If true, generates summarization for the whole transcription.","default":false},"summarization_config":{"properties":{"type":{"type":"string","description":"The type of summarization to apply","default":"general","enum":["general","bullet_points","concise"]}},"type":"object","description":"Summarization configuration, if `summarization` is enabled"},"chapterization":{"type":"boolean","description":"If true, generates chapters for the whole transcription.","default":false}},"type":"object","description":"Specify the post-processing configuration"},"messages_config":{"properties":{"receive_final_transcripts":{"type":"boolean","description":"If true, final utterance will be sent to websocket.","default":true},"receive_speech_events":{"type":"boolean","description":"If true, begin and end speech events will be sent to websocket.","default":true},"receive_pre_processing_events":{"type":"boolean","description":"If true, pre-processing events will be sent to websocket.","default":true},"receive_realtime_processing_events":{"type":"boolean","description":"If true, realtime processing events will be sent to websocket.","default":true},"receive_post_processing_events":{"type":"boolean","description":"If true, post-processing events will be sent to websocket.","default":true},"receive_acknowledgments":{"type":"boolean","description":"If true, acknowledgments will be sent to websocket.","default":true},"receive_errors":{"type":"boolean","description":"If true, errors will be sent to websocket.","default":true},"receive_lifecycle_events":{"type":"boolean","description":"If true, lifecycle events will be sent to websocket.","default":false}},"type":"object","description":"Specify the websocket messages configuration"},"callback":{"type":"boolean","description":"If true, messages will be sent to configured url.","default":false},"callback_config":{"properties":{"url":{"type":"string","description":"URL on which we will do a `POST` request with configured messages","example":"https://callback.example","format":"uri"},"receive_final_transcripts":{"type":"boolean","description":"If true, final utterance will be sent to the defined callback.","default":true},"receive_speech_events":{"type":"boolean","description":"If true, begin and end speech events will be sent to the defined callback.","default":false},"receive_pre_processing_events":{"type":"boolean","description":"If true, pre-processing events will be sent to the defined callback.","default":true},"receive_realtime_processing_events":{"type":"boolean","description":"If true, realtime processing events will be sent to the defined callback.","default":true},"receive_post_processing_events":{"type":"boolean","description":"If true, post-processing events will be sent to the defined callback.","default":true},"receive_acknowledgments":{"type":"boolean","description":"If true, acknowledgments will be sent to the defined callback.","default":false},"receive_errors":{"type":"boolean","description":"If true, errors will be sent to the defined callback.","default":false},"receive_lifecycle_events":{"type":"boolean","description":"If true, lifecycle events will be sent to the defined callback.","default":true}},"type":"object","description":"Specify the callback configuration"}},"title":"GladiaV2 Real-time Transcription Settings","description":"Docs: https://docs.gladia.io/api-reference/v2/live/init"},"rev_streaming":{"type":"object","properties":{"obscure_expletives":{"type":"boolean"},"delete_after":{"type":"string","format":"date-span"},"audio_options._content_type":{"type":"string"},"audio_options._layout":{"type":"string"},"audio_options._rate":{"type":"integer","format":"int32"},"audio_options._format":{"type":"string"},"audio_options._channels":{"type":"integer","format":"int32"},"transcriber":{"enum":[0,1],"type":"integer","format":"int32"},"language":{"type":"string"},"metadata":{"maxLength":512,"minLength":0,"type":"string"},"filter_profanity":{"type":"boolean"},"remove_disfluencies":{"type":"boolean"},"detailed_partials":{"type":"boolean"},"custom_vocabulary_id":{"type":"string"},"delete_after_seconds":{"type":"integer","format":"int32"},"max_segment_duration_seconds":{"maximum":30,"minimum":5,"type":"integer","format":"int32"},"max_connection_wait_seconds":{"maximum":600,"minimum":60,"type":"integer","format":"int32"},"allow_interruption":{"type":"boolean"},"enable_speaker_switch":{"type":"boolean"},"start_ts":{"type":"string","format":"date-span"},"skip_postprocessing":{"type":"boolean"},"priority":{"enum":[0,1],"type":"integer","format":"int32"},"user_agent":{"type":"string"}},"title":"Rev Real-time Transcription Settings","description":"Docs: https://docs.rev.ai/api/streaming/requests/"},"aws_transcribe_streaming":{"type":"object","description":"You must specify either:\n- `language_code`(e.g `en-US`) OR\n- Set `language_identification` to `true` AND specify `language_options`(e.g `en-US,fr-FR,es-US,de-DE,it-IT`).\n\nDocs: https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html","properties":{"language_code":{"type":"string","description":"Specify the language code that represents the language spoken. If you're unsure of the language spoken in your audio, consider using IdentifyLanguage to enable automatic language identification."},"vocabulary_filter_method":{"type":"string","description":"Specify how you want your vocabulary filter applied to your transcript. To replace words with ***, choose mask. To delete words, choose remove. To flag words without changing them, choose tag."},"vocabulary_filter_name":{"type":"string","description":"Specify the name of the custom vocabulary filter that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive.  If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region. If you include IdentifyLanguage and want to use one or more vocabulary filters with your transcription, use the VocabularyFilterNames parameter instead."},"vocabulary_name":{"type":"string","description":"Specify the name of the custom vocabulary that you want to use when processing your transcription. Note that vocabulary names are case sensitive. If you use Amazon Transcribe multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region. If you include IdentifyLanguage and want to use one or more custom vocabularies with your transcription, use the VocabularyNames parameter instead."},"region":{"type":"string","description":"The Amazon Web Services Region in which to use Amazon Transcribe. If you don't specify a Region, then the MediaRegion of the meeting is used. However, if Amazon Transcribe is not available in the MediaRegion, then a TranscriptFailed event is sent. Use auto to use Amazon Transcribe in a Region near the meeting’s MediaRegion. For more information, refer to Choosing a transcription Region in the Amazon Chime SDK Developer Guide."},"enable_partial_results_stabilization":{"type":"boolean","description":"Enables partial result stabilization for your transcription. Partial result stabilization can reduce latency in your output, but may impact accuracy."},"partial_results_stability":{"type":"string","description":"Specify the level of stability to use when you enable partial results stabilization (EnablePartialResultsStabilization). Low stability provides the highest accuracy. High stability transcribes faster, but with slightly lower accuracy."},"content_identification_type":{"type":"string","description":"Labels all personally identifiable information (PII) identified in your transcript. If you don't include PiiEntityTypes, all PII is identified.  You can’t set ContentIdentificationType and ContentRedactionType. "},"content_redaction_type":{"type":"string","description":"Content redaction is performed at the segment level. If you don't include PiiEntityTypes, all PII is redacted.  You can’t set ContentRedactionType and ContentIdentificationType. "},"pii_entity_types":{"type":"string","description":"Specify which types of personally identifiable information (PII) you want to redact in your transcript. You can include as many types as you'd like, or you can select ALL. Values must be comma-separated and can include: ADDRESS, BANK_ACCOUNT_NUMBER, BANK_ROUTING, CREDIT_DEBIT_CVV, CREDIT_DEBIT_EXPIRY CREDIT_DEBIT_NUMBER, EMAIL,NAME, PHONE, PIN, SSN, or ALL. Note that if you include PiiEntityTypes, you must also include ContentIdentificationType or ContentRedactionType. If you include ContentRedactionType or ContentIdentificationType, but do not include PiiEntityTypes, all PII is redacted or identified."},"language_model_name":{"type":"string","description":"Specify the name of the custom language model that you want to use when processing your transcription. Note that language model names are case sensitive. The language of the specified language model must match the language code. If the languages don't match, the custom language model isn't applied. There are no errors or warnings associated with a language mismatch. If you use Amazon Transcribe in multiple Regions, the custom language model must be available in Amazon Transcribe in each Region."},"identify_language":{"type":"boolean","description":"Enables automatic language identification for your transcription. If you include IdentifyLanguage, you can optionally use LanguageOptions to include a list of language codes that you think may be present in your audio stream. Including language options can improve transcription accuracy. You can also use PreferredLanguage to include a preferred language. Doing so can help Amazon Transcribe identify the language faster. You must include either LanguageCode or IdentifyLanguage. Language identification can't be combined with custom language models or redaction."},"language_options":{"type":"string","description":"Specify two or more language codes that represent the languages you think may be present in your media; including more than five is not recommended. If you're unsure what languages are present, do not include this parameter. Including language options can improve the accuracy of language identification. If you include LanguageOptions, you must also include IdentifyLanguage.  You can only include one language dialect per language. For example, you cannot include en-US and en-AU. "},"preferred_language":{"type":"string","description":"Specify a preferred language from the subset of languages codes you specified in LanguageOptions. You can only use this parameter if you include IdentifyLanguage and LanguageOptions."},"vocabulary_names":{"type":"string","description":"Specify the names of the custom vocabularies that you want to use when processing your transcription. Note that vocabulary names are case sensitive. If you use Amazon Transcribe in multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region. If you don't include IdentifyLanguage and want to use a custom vocabulary with your transcription, use the VocabularyName parameter instead."},"vocabulary_filter_names":{"type":"string","description":"Specify the names of the custom vocabulary filters that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive. If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region.  If you're not including IdentifyLanguage and want to use a custom vocabulary filter with your transcription, use the VocabularyFilterName parameter instead."}},"oneOf":[{"required":["language_code"]},{"required":["identify_language","language_options"],"properties":{"identify_language":{"type":"boolean","enum":[true]}}}],"title":"AWS Transcribe Streaming Transcription Settings"},"speechmatics_streaming":{"type":"object","properties":{"language":{"type":"string"},"domain":{"type":"string","description":"Request a specialized model based on 'language' but optimized for a particular field, e.g. \"finance\" or \"medical\"."},"output_locale":{"type":"string","minLength":1},"additional_vocab":{"type":"array","items":{"type":"object","oneOf":[{"type":"string","minLength":1},{"type":"object","properties":{"content":{"type":"string","minLength":1},"sounds_like":{"type":"array","items":{"type":"string","minLength":1},"minItems":1}},"required":["content"]}]}},"diarization":{"type":"string","enum":["none","speaker"]},"max_delay":{"type":"number","minimum":0},"max_delay_mode":{"type":"string","enum":["flexible","fixed"]},"speaker_diarization_config":{"type":"object","properties":{"max_speakers":{"type":"number","format":"integer","minimum":2,"maximum":100},"prefer_current_speaker":{"type":"boolean"},"speaker_sensitivity":{"type":"number","format":"float","minimum":0,"maximum":1}}},"audio_filtering_config":{"type":"object","properties":{"volume_threshold":{"type":"number","format":"float","minimum":0,"maximum":100}}},"transcript_filtering_config":{"type":"object","properties":{"remove_disfluencies":{"type":"boolean"},"replacements":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"]}}}},"enable_partials":{"type":"boolean","default":false},"enable_entities":{"type":"boolean","default":true},"operating_point":{"type":"string","enum":["standard","enhanced"]},"punctuation_overrides":{"type":"object","properties":{"permitted_marks":{"type":"array","description":"The punctuation marks which the client is prepared to accept in transcription output, or the special value 'all' (the default). Unsupported marks are ignored. This value is used to guide the transcription process.","items":{"pattern":"^(.|all)$","type":"string"}},"sensitivity":{"type":"number","description":"Ranges between zero and one. Higher values will produce more punctuation. The default is 0.5.","format":"float","maximum":1,"minimum":0}}},"conversation_config":{"type":"object","properties":{"end_of_utterance_silence_trigger":{"type":"number","format":"float","minimum":0,"maximum":2,"default":0}},"description":"This mode will detect when a speaker has stopped talking. The end_of_utterance_silence_trigger is the time in seconds after which the server will assume that the speaker has finished speaking, and will emit an EndOfUtterance message. A value of 0 disables the feature."}},"required":["language"],"title":"Speechmatics Real-time Transcription Settings","description":"You must specify `language` (e.g `en`)\n\nDocs: https://docs.speechmatics.com/rt-api-ref#transcription-config"},"elevenlabs_streaming":{"type":"object","properties":{"model_id":{"description":"The model to use for transcription.","type":"string","default":"eleven_whisper_v2_realtime"},"language_code":{"description":"ISO 639-1 two-letter language code. When not specified, the model auto-detects the language.","type":"string"},"previous_text":{"description":"Text from a previous transcription session to provide context for the model. Sent in the first message to the WebSocket.","type":"string"}},"title":"ElevenLabs Real-time Transcription Settings","description":"Docs: https://elevenlabs.io/docs/api-reference/speech-to-text"},"meeting_captions":{"type":"object","properties":{"language_code":{"enum":["cs","de","en","es","fil","fr","he","hi","it","ja","ko","nl","pl","pt","pt-BR","ro","ru","sv","th","tr","uk","vi","zh",null],"type":"string","description":"* `cs` - Czech\n* `de` - German\n* `en` - English\n* `es` - Spanish\n* `fil` - Filipino\n* `fr` - French\n* `he` - Hebrew\n* `hi` - Hindi\n* `it` - Italian\n* `ja` - Japanese\n* `ko` - Korean\n* `nl` - Dutch\n* `pl` - Polish\n* `pt` - Portuguese\n* `pt-BR` - Portuguese (Brazil)\n* `ro` - Romanian\n* `ru` - Russian\n* `sv` - Swedish\n* `th` - Thai\n* `tr` - Turkish\n* `uk` - Ukrainian\n* `vi` - Vietnamese\n* `zh` - Chinese","nullable":true,"title":"Language for captions. If not specified, the selection is meeting platform-specific."}}},"zoom_rtms":{"type":"object","title":"Zoom Real-Time Media Streams Transcription"}}},"TranscriptArtifactShortcut":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/ArtifactStatus"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"data":{"allOf":[{"$ref":"#/components/schemas/TranscriptArtifactData"}],"readOnly":true},"diarization":{"allOf":[{"$ref":"#/components/schemas/TranscriptArtifactDiarization"}],"readOnly":true,"nullable":true},"provider":{"allOf":[{"$ref":"#/components/schemas/TranscriptArtifactProvider"}],"readOnly":true}},"required":["created_at","data","diarization","id","metadata","provider","status"]},"TranscriptArtifactShortcutRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}},"required":["metadata"]},"UsageResponse":{"type":"object","description":"Serializer for usage statistics response.","properties":{"bot_total":{"type":"number","format":"double","description":"The total amount of time, in seconds, of bots used."}},"required":["bot_total"]},"VideoMixedArtifact":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"recording":{"allOf":[{"$ref":"#/components/schemas/RecordingMinimal"}],"readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/ArtifactStatus"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"data":{"allOf":[{"$ref":"#/components/schemas/VideoMixedArtifactData"}],"readOnly":true},"format":{"allOf":[{"$ref":"#/components/schemas/Format3b3Enum"}],"readOnly":true,"description":"Format of the mixed video file\n\n* `mp4` - Mp4"}},"required":["created_at","data","format","id","metadata","recording","status"]},"VideoMixedArtifactData":{"type":"object","properties":{"download_url":{"type":"string","format":"uri","readOnly":true,"nullable":true}},"required":["download_url"]},"VideoMixedArtifactShortcut":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/ArtifactStatus"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"data":{"allOf":[{"$ref":"#/components/schemas/VideoMixedArtifactData"}],"readOnly":true},"format":{"allOf":[{"$ref":"#/components/schemas/Format3b3Enum"}],"readOnly":true,"description":"Format of the mixed video file\n\n* `mp4` - Mp4"}},"required":["created_at","data","format","id","metadata","status"]},"VideoMixedArtifactShortcutRequest":{"type":"object","properties":{"metadata":{"type":"object","additionalProperties":{"type":"string"}}},"required":["metadata"]},"VideoMixedLayoutEnum":{"enum":["speaker_view","gallery_view","gallery_view_v2","audio_only"],"type":"string","description":"* `speaker_view` - speaker_view\n* `gallery_view` - gallery_view\n* `gallery_view_v2` - gallery_view_v2\n* `audio_only` - audio_only"},"VideoMixedParticipantVideoWhenScreenshareEnum":{"enum":["hide","beside","overlap"],"type":"string","description":"* `hide` - hide\n* `beside` - beside\n* `overlap` - overlap"},"VideoOutput":{"type":"object","properties":{"kind":{"allOf":[{"$ref":"#/components/schemas/VideoOutputKindEnum"}],"description":"The kind of data encoded in b64_data\n\n* `jpeg` - jpeg"}},"required":["kind"]},"VideoOutputKindEnum":{"enum":["jpeg"],"type":"string","description":"* `jpeg` - jpeg"},"VideoOutputRequest":{"type":"object","properties":{"kind":{"allOf":[{"$ref":"#/components/schemas/VideoOutputKindEnum"}],"description":"The kind of data encoded in b64_data\n\n* `jpeg` - jpeg"},"b64_data":{"type":"string","writeOnly":true,"minLength":1,"description":"Data encoded in Base64 format, using the standard alphabet (specified here: https://datatracker.ietf.org/doc/html/rfc4648#section-4)","maxLength":1835008}},"required":["b64_data","kind"]},"VideoSeparateArtifact":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"recording":{"allOf":[{"$ref":"#/components/schemas/RecordingMinimal"}],"readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/ArtifactStatus"}],"readOnly":true},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"data":{"allOf":[{"$ref":"#/components/schemas/VideoSeparateArtifactData"}],"readOnly":true},"format":{"allOf":[{"$ref":"#/components/schemas/VideoSeparateArtifactFormatEnum"}],"readOnly":true,"description":"Format of the participant separated video files\n\n* `mp4` - Mp4\n* `h264` - H264"}},"required":["created_at","data","format","id","metadata","recording","status"]},"VideoSeparateArtifactData":{"type":"object","properties":{"download_url":{"type":"string","format":"uri","readOnly":true,"nullable":true,"description":"Download all video separate parts for the recording. **[See response format here](https://docs.recall.ai/docs/download-schemas#json-video-separate-download-url)**"}},"required":["download_url"]},"VideoSeparateArtifactFormatEnum":{"enum":["mp4","h264"],"type":"string","description":"* `mp4` - Mp4\n* `h264` - H264"},"Webex":{"type":"object","properties":{"login_group_name":{"type":"string","default":"Default","description":"The name of the Webex login group to use for this meeting."}}},"WebexEnum":{"enum":["web","web_4_core","web_gpu"],"type":"string","description":"* `web` - web\n* `web_4_core` - web_4_core\n* `web_gpu` - web_gpu"},"WebexInvite":{"type":"object","properties":{"meeting_subdomain":{"type":"string"},"meeting_path":{"type":"string","description":"This value is available only for Scheduled Webex meetings."},"meeting_mtid":{"type":"string","description":"This value is available only for Scheduled Webex meetings."},"meeting_personal_room_id":{"type":"string","description":"This value is available only for Personal room Webex meetings."}},"required":["meeting_subdomain"]},"WebexMeetingInvite":{"type":"object","properties":{"platform":{"$ref":"#/components/schemas/WebexMeetingInvitePlatformEnum"},"meeting_subdomain":{"type":"string"},"meeting_personal_room_id":{"type":"string","description":"Required for personal room meetings."},"meeting_mtid":{"type":"string","description":"Required for scheduled/spaces meetings."},"meeting_path":{"type":"string","description":"Required for scheduled/spaces meetings."}},"required":["meeting_subdomain","platform"]},"WebexMeetingInvitePlatformEnum":{"enum":["webex"],"type":"string","description":"* `webex` - webex"},"WebexRequest":{"type":"object","properties":{"login_group_name":{"type":"string","minLength":1,"default":"Default","description":"The name of the Webex login group to use for this meeting."}}},"Zoom":{"type":"object","properties":{"join_token_url":{"type":"string","format":"uri","description":"A URL which Recall will make a GET request to, in order to retrieve the Zoom Join Token for Local Recording, which the Zoom bot uses to automatically record. This token can be generated through the Zoom API. Docs: https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/meetingLocalRecordingJoinToken"},"zak_url":{"type":"string","format":"uri","description":"A URL which Recall will make  GET request to, in order to retrieve the ZAK. The V1 Zoom bot uses this to join meetings that require authentication to join.This token can be generated through the Zoom API. Docs: https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/userZak"},"obf_token_url":{"type":"string","format":"uri","description":"A URL which Recall will make a GET request to, in order to retrieve the OBF (On Behalf Of) token. The bot uses this to join on behalf of another Zoom user. This token can be generated through the Zoom API. Docs: https://developers.zoom.us/docs/api/rest/reference/user/methods/#operation/userToken"},"user_email":{"type":"string","format":"email","description":"This is only required for registration-required webinars. This should be the email address registered for the webinar."}}},"ZoomAccessToken":{"type":"object","properties":{"token":{"type":"string"},"expires_at":{"type":"string","format":"date-time"}},"required":["expires_at","token"]},"ZoomAuthorizationCode":{"type":"object","properties":{"code":{"type":"string"},"redirect_uri":{"type":"string","format":"uri"},"code_verifier":{"type":"string"}},"required":["code","redirect_uri"]},"ZoomAuthorizationCodeRequest":{"type":"object","properties":{"code":{"type":"string","minLength":1},"redirect_uri":{"type":"string","format":"uri","minLength":1},"code_verifier":{"type":"string","minLength":1}},"required":["code","redirect_uri"]},"ZoomEnum":{"type":"string","enum":["web","web_4_core","web_gpu"]},"ZoomMeetingInvite":{"type":"object","properties":{"meeting_id":{"type":"string"},"meeting_password":{"type":"string","nullable":true},"tk":{"type":"string","nullable":true},"zak":{"type":"string","nullable":true}},"required":["meeting_id"]},"ZoomMeetingInviteMeetingLink":{"type":"object","properties":{"platform":{"$ref":"#/components/schemas/ZoomMeetingInviteMeetingLinkPlatformEnum"},"meeting_id":{"type":"string"},"meeting_password":{"type":"string","nullable":true},"tk":{"type":"string","nullable":true},"zak":{"type":"string","nullable":true}},"required":["meeting_id","platform"]},"ZoomMeetingInviteMeetingLinkPlatformEnum":{"enum":["zoom"],"type":"string","description":"* `zoom` - zoom"},"ZoomMeetingToCredential":{"type":"object","properties":{"meeting_id":{"type":"integer","maximum":9223372036854776000,"minimum":-9223372036854776000,"format":"int64"},"credential":{"type":"string","format":"uuid"},"synced_at":{"type":"string","format":"date-time","readOnly":true}},"required":["credential","meeting_id","synced_at"]},"ZoomOAuthApp":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"kind":{"$ref":"#/components/schemas/ZoomOAuthAppKindEnum"},"client_id":{"type":"string","maxLength":200},"client_secret":{"type":"string","maxLength":200},"webhook_secret":{"type":"string","maxLength":200},"webhook_last_validation":{"type":"string","format":"date-time","readOnly":true,"nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true}},"required":["client_id","client_secret","created_at","id","kind","webhook_last_validation","webhook_secret"]},"ZoomOAuthAppKindEnum":{"enum":["user_level","account_level"],"type":"string","description":"* `user_level` - User Level\n* `account_level` - Account Level"},"ZoomOAuthAppLog":{"type":"object","properties":{"oauth_app":{"type":"string","format":"uuid"},"message":{"type":"string","maxLength":2000},"created_at":{"type":"string","format":"date-time","readOnly":true}},"required":["created_at","message","oauth_app"]},"ZoomOAuthAppRequest":{"type":"object","properties":{"kind":{"$ref":"#/components/schemas/ZoomOAuthAppKindEnum"},"client_id":{"type":"string","minLength":1,"maxLength":200},"client_secret":{"type":"string","minLength":1,"maxLength":200},"webhook_secret":{"type":"string","minLength":1,"maxLength":200}},"required":["client_id","client_secret","kind","webhook_secret"]},"ZoomOAuthCredential":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"oauth_app":{"type":"string","format":"uuid"},"status":{"allOf":[{"$ref":"#/components/schemas/ZoomOAuthCredentialStatusEnum"}],"readOnly":true},"user_id":{"type":"string","readOnly":true,"nullable":true},"account_id":{"type":"string","readOnly":true,"nullable":true},"access_token_callback_url":{"type":"string","nullable":true,"description":"The url to retrieve access token from. Applicable for **Customer Managed OAuth** flow.","maxLength":200},"created_at":{"type":"string","format":"date-time","readOnly":true},"meeting_sync_status":{"allOf":[{"$ref":"#/components/schemas/MeetingSyncStatusEnum"}],"readOnly":true,"description":"This field tracks the status of initial meeting sync on the credential. This operation is processed asynchronously when the credential is created or when the sync meetings endpoint is called.\n\n* `not_started` - Not Started\n* `in_progress` - In Progress\n* `completed` - Completed\n* `failed` - Failed"}},"required":["account_id","created_at","id","meeting_sync_status","oauth_app","status","user_id"]},"ZoomOAuthCredentialBadRequest":{"type":"object","properties":{"detail":{"type":"string"},"conflicting_zoom_account_id":{"type":"string","description":"The Zoom account ID of the conflicting credential, if any."},"conflicting_zoom_user_id":{"type":"string","description":"The Zoom user ID of the conflicting credential, if any."}},"required":["detail"]},"ZoomOAuthCredentialLog":{"type":"object","properties":{"credential":{"type":"string","format":"uuid"},"message":{"type":"string","maxLength":2000},"created_at":{"type":"string","format":"date-time","readOnly":true}},"required":["created_at","credential","message"]},"ZoomOAuthCredentialRequest":{"type":"object","properties":{"oauth_app":{"type":"string","format":"uuid"},"authorization_code":{"allOf":[{"$ref":"#/components/schemas/ZoomAuthorizationCodeRequest"}],"writeOnly":true,"description":"Data received from Zoom after the user has authorized the app. Applicable for **Recall Managed OAuth** flow."},"access_token_callback_url":{"type":"string","nullable":true,"minLength":1,"description":"The url to retrieve access token from. Applicable for **Customer Managed OAuth** flow.","maxLength":200}},"required":["oauth_app"]},"ZoomOAuthCredentialStatusEnum":{"enum":["healthy","unhealthy"],"type":"string","description":"* `healthy` - Healthy\n* `unhealthy` - Unhealthy"},"ZoomRequest":{"type":"object","properties":{"join_token_url":{"type":"string","format":"uri","minLength":1,"description":"A URL which Recall will make a GET request to, in order to retrieve the Zoom Join Token for Local Recording, which the Zoom bot uses to automatically record. This token can be generated through the Zoom API. Docs: https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/meetingLocalRecordingJoinToken"},"zak_url":{"type":"string","format":"uri","minLength":1,"description":"A URL which Recall will make  GET request to, in order to retrieve the ZAK. The V1 Zoom bot uses this to join meetings that require authentication to join.This token can be generated through the Zoom API. Docs: https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/userZak"},"obf_token_url":{"type":"string","format":"uri","minLength":1,"description":"A URL which Recall will make a GET request to, in order to retrieve the OBF (On Behalf Of) token. The bot uses this to join on behalf of another Zoom user. This token can be generated through the Zoom API. Docs: https://developers.zoom.us/docs/api/rest/reference/user/methods/#operation/userToken"},"user_email":{"type":"string","format":"email","minLength":1,"description":"This is only required for registration-required webinars. This should be the email address registered for the webinar."}}},"ZoomRtms":{"type":"object","properties":{"meeting_uuid":{"type":"string"},"rtms_stream_id":{"type":"string"},"server_urls":{"type":"string"},"signature":{"type":"string"}},"required":["meeting_uuid","rtms_stream_id","server_urls","signature"]},"ZoomRtmsRequest":{"type":"object","properties":{"meeting_uuid":{"type":"string","minLength":1},"rtms_stream_id":{"type":"string","minLength":1},"server_urls":{"type":"string","minLength":1},"signature":{"type":"string","minLength":1}},"required":["meeting_uuid","rtms_stream_id","server_urls","signature"]},"_BreakoutRoomSchema":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/_BreakoutRoomSchemaModeEnum"},"room_id":{"type":"string","format":"uuid","description":"Required when mode='join_specific_room'."}},"required":["mode"]},"_BreakoutRoomSchemaModeEnum":{"enum":["join_main_room","join_specific_room","auto_accept_all_invites"],"type":"string","description":"* `join_main_room` - join_main_room\n* `join_specific_room` - join_specific_room\n* `auto_accept_all_invites` - auto_accept_all_invites"},"_BreakoutRoomSchemaRequest":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/_BreakoutRoomSchemaModeEnum"},"room_id":{"type":"string","format":"uuid","description":"Required when mode='join_specific_room'."}},"required":["mode"]}},"securitySchemes":{"CalendarJwtAuthentication":{"type":"apiKey","in":"header","name":"x-recallcalendarauthtoken"},"tokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Token-based authentication with required prefix \"Token\""}}},"servers":[{"url":"https://us-east-1.recall.ai","description":"Recall.ai API"},{"url":"https://eu-central-1.recall.ai","description":"European Recall.ai API"},{"url":"https://ap-northeast-1.recall.ai","description":"Asia Recall.ai API"},{"url":"https://us-west-2.recall.ai","description":"Pay-as-you-go Recall.ai API"}]}