{"command":{"effect":"write","timeoutSeconds":120,"inputSchema":{"type":"object","description":"Create a Live WebRTC session or place an outbound SIP call. Start with the\n[Live prompting guide](https://developers.openai.com/api/docs/guides/live-prompting) for session configuration\nand [Telephony and SIP](https://developers.openai.com/api/docs/guides/voice-sip?api=live#place-an-outbound-call)\nfor trunk setup and call monitoring.\n\nSet transport.type to `webrtc` and supply an SDP offer, or set it to `sip`\nand supply an E.164 destination and trunk credentials.\nRinging is limited to 3 minutes and connected calls to 2 hours; these limits\nare not configurable in the request.\n\nReturns `201 Created` after session initialization. WebRTC responses include an\nSDP answer. SIP responses do not wait for the callee to answer. Attach a\nsideband connection using session.id to monitor SIP call progress.\n\nEach SIP request creates a new call. If a request times out or the connection\nfails, retry with caution: the original request may have succeeded, and a\nretry can place another call.","properties":{"body":{"$ref":"#/definitions/LiveSessionCreateRequest"}},"required":["body"],"additionalProperties":false,"definitions":{"LiveSessionCreateRequest":{"type":"object","description":"Create a Live session with a WebRTC SDP offer or place an outbound SIP call. Follow the [Live prompting guide](https://developers.openai.com/api/docs/guides/live-prompting) before choosing frontend and backend instructions. The request starts the session; do not send session.start again on the data channel or sideband.","properties":{"session":{"$ref":"#/definitions/LiveMediaSessionCreateParams"},"transport":{"description":"WebRTC transport with an SDP offer, or SIP transport with a destination and per-call trunk credentials.","oneOf":[{"$ref":"#/definitions/LiveWebRTCTransport"},{"$ref":"#/definitions/LiveSIPTransport"}]}},"required":["session","transport"],"additionalProperties":false},"LiveMediaSessionCreateParams":{"type":"object","description":"Startup configuration for a Live media session. Follow the [Live prompting guide](https://developers.openai.com/api/docs/guides/live-prompting) when writing frontend instructions and the backend prompt under delegation.responses.instructions.","properties":{"model":{"$ref":"#/definitions/ModelIdsLive"},"instructions":{"$ref":"#/definitions/instructions"},"audio":{"$ref":"#/definitions/LiveMediaSessionAudioParam"},"delegation":{"$ref":"#/definitions/delegation"},"triggers":{"$ref":"#/definitions/triggers"},"store":{"$ref":"#/definitions/store"},"input":{"$ref":"#/definitions/input"},"client":{"$ref":"#/definitions/LiveClientConfigParam"}},"required":["model"],"additionalProperties":false},"LiveWebRTCTransport":{"type":"object","description":"WebRTC transport carrying the offer SDP in a creation request or answer SDP in its response.","properties":{"type":{"type":"string","description":"The transport used for the Live session. Always `webrtc`.","enum":["webrtc"]},"sdp":{"type":"string","minLength":1,"description":"Session Description Protocol message for the WebRTC connection."}},"required":["type","sdp"],"additionalProperties":false},"LiveSIPTransport":{"type":"object","description":"Place an outbound SIP call using your provider's trunk. The trunk must support TLS signaling, Opus audio, and SDES-SRTP media. See [Telephony and SIP](https://developers.openai.com/api/docs/guides/voice-sip?api=live#place-an-outbound-call).","properties":{"type":{"type":"string","description":"The transport used for the Live session. Always `sip`.","enum":["sip"]},"destination":{"type":"string","description":"Phone number to call in E.164 format. SIP URI destinations are not supported.","pattern":"^\\+[1-9][0-9]{1,14}$","examples":["+14155550123"]},"trunk":{"$ref":"#/definitions/LiveSIPTrunk"}},"required":["type","destination","trunk"],"additionalProperties":false},"ModelIdsLive":{"description":"The Live model. Required in the session configuration for every transport; do not pass it as a URL query parameter.","anyOf":[{"type":"string","minLength":1},{"type":"string","enum":["gpt-live-1"]}],"examples":["gpt-live-1"]},"instructions":{"anyOf":[{"description":"Frontend instructions for voice, conversation, interruptions, and when to delegate. Start with the [Live prompting guide](https://developers.openai.com/api/docs/guides/live-prompting); put business rules and tool workflows in a separate [backend prompt](https://developers.openai.com/api/docs/guides/live-delegation#start-with-your-existing-backend-prompt). Limited to 16,384 client-supplied tokens. Omitted or blank instructions use server defaults. Immutable after startup.","type":"string"},{"type":"null"}]},"LiveMediaSessionAudioParam":{"type":"object","description":"Startup audio output configuration. WebRTC and SIP negotiate the media format; audio.format is only accepted for primary WebSockets. Voice cannot change after startup.","properties":{"output":{"$ref":"#/definitions/LiveInitialSessionAudioOutputParam"}},"additionalProperties":false},"delegation":{"anyOf":[{"description":"Who handles tasks delegated by the Live model. Omitted or null selects your application; use `responses` or `decisions` to delegate to the corresponding API.","oneOf":[{"$ref":"#/definitions/LiveClientDelegationParam"},{"$ref":"#/definitions/LiveResponsesDelegationParam"},{"$ref":"#/definitions/LiveDecisionsDelegationParam"}]},{"type":"null"}]},"triggers":{"description":"At most one Decisions trigger per transcript event type. Triggers run independently of delegation. On update, omit triggers to keep the current configuration, send a list to replace it, or send an empty list to disable triggers.","type":"array","items":{"$ref":"#/definitions/LiveDecisionTriggerInputParam"},"maxItems":2},"store":{"description":"Whether to store the session for later forking and recording download. Defaults to false for new sessions.","type":"boolean"},"input":{"description":"Ordered text-only history supplied before startup. Supports developer, user, and assistant messages with one text part each; at most 128 messages and a configured rendered-token limit (8,192 by default).","type":"array","items":{"$ref":"#/definitions/LiveInitialItem"},"maxItems":128},"LiveClientConfigParam":{"description":"Startup-only capabilities for an untrusted frontend attached to a unified WebRTC session. Trusted sideband connections are unaffected.","type":"object","properties":{"data_channel":{"$ref":"#/definitions/LiveDataChannelConfigParam"}},"required":["data_channel"]},"LiveSIPTrunk":{"type":"object","description":"SIP trunk configuration supplied for this call. Keep trunk credentials on your server. The creation response does not return this configuration.","properties":{"provider_url":{"type":"string","description":"Provider endpoint in the form `sips:host[:port][;transport=tcp]`. The default port is 5061. IPv6 addresses must be bracketed. TLS signaling is required; plaintext SIP is not supported. Do not include userinfo, a path, URI headers, or other URI parameters. Local hostnames and literal private, loopback, link-local, unspecified, multicast, and broadcast IP addresses are rejected.","examples":["sips:sip.example.com:5061"]},"auth":{"$ref":"#/definitions/LiveSIPTrunkAuth"},"caller_number":{"type":"string","description":"Caller phone number in E.164 format to use in the SIP From header.","pattern":"^\\+[1-9][0-9]{1,14}$","examples":["+14155550100"]}},"required":["provider_url","auth","caller_number"],"additionalProperties":false},"LiveInitialSessionAudioOutputParam":{"description":"Settings for speech generated by the Live model. Choose the voice before starting the session.","type":"object","properties":{"voice":{"description":"The voice used for Live speech, as a built-in voice name or a custom voice object containing its ID. Defaults to `marin` and cannot change after startup.","oneOf":[{"anyOf":[{"type":"string"},{"type":"string","enum":["alloy","ash","ballad","beacon","bossa","brise","cedar","cinder","coral","delta","echo","flitz","gleam","harema","juni","marin","meridian","nira","noeul","nuri","quartz","ripple","sage","shida","shimmer","sillage","stone","tempo","verse","vesper","willow"]}]},{"$ref":"#/definitions/LiveCustomVoiceParam"}]}},"required":[]},"LiveClientDelegationParam":{"description":"Delegate tasks to your application. The Live session emits delegation events that your backend handles.","type":"object","properties":{"acknowledgement_delay_ms":{"description":"Milliseconds to wait before requesting an automatic spoken acknowledgement for a delegation. The model may still speak before this delay. Any commentary or thinking appended to the session cancels all pending acknowledgements, including those for other delegations. Defaults to 400 for Decisions sessions and 0 (request immediately) for other sessions. Omission in a session update preserves the current value. Updates apply to subsequent delegations.","type":"integer","minimum":0,"maximum":800},"type":{"description":"The delegation owner. Always `client` for tasks handled by your application.","default":"client","type":"string","enum":["client"]}},"required":["type"]},"LiveResponsesDelegationParam":{"description":"Delegate tasks to a Responses model managed by the Live session.","type":"object","properties":{"acknowledgement_delay_ms":{"description":"Milliseconds to wait before requesting an automatic spoken acknowledgement for a delegation. The model may still speak before this delay. Any commentary or thinking appended to the session cancels all pending acknowledgements, including those for other delegations. Defaults to 400 for Decisions sessions and 0 (request immediately) for other sessions. Omission in a session update preserves the current value. Updates apply to subsequent delegations.","type":"integer","minimum":0,"maximum":800},"type":{"description":"The delegation owner. Always `responses` for tasks handled by the Responses API.","default":"responses","type":"string","enum":["responses"]},"responses":{"$ref":"#/definitions/LiveResponsesDelegationSettingsInputParam"}},"required":["type","responses"]},"LiveDecisionsDelegationParam":{"type":"object","properties":{"acknowledgement_delay_ms":{"description":"Milliseconds to wait before requesting an automatic spoken acknowledgement for a delegation. The model may still speak before this delay. Any commentary or thinking appended to the session cancels all pending acknowledgements, including those for other delegations. Defaults to 400. Updates apply to subsequent delegations.","type":"integer","minimum":0,"maximum":800},"type":{"default":"decisions","type":"string","enum":["decisions"]},"decisions":{"$ref":"#/definitions/LiveDecisionsSettingsInputParam"}},"required":["type","decisions"]},"LiveDecisionTriggerInputParam":{"type":"object","properties":{"type":{"default":"decisions","type":"string","enum":["decisions"]},"event_type":{"type":"string","enum":["session.input_transcript.delta","session.output_transcript.delta"]},"decisions":{"$ref":"#/definitions/LiveDecisionQuestionsInputParam"}},"required":["type","event_type","decisions"],"additionalProperties":false},"LiveInitialItem":{"description":"A developer, user, or assistant message supplied as text history before the Live session starts.","oneOf":[{"$ref":"#/definitions/LiveInitialDeveloperMessageItemParam"},{"$ref":"#/definitions/LiveInitialUserMessageItemParam"},{"$ref":"#/definitions/LiveInitialAssistantMessageItemParam"}]},"LiveDataChannelConfigParam":{"description":"Control which Live events an untrusted WebRTC frontend can send and receive over its data channel. These restrictions do not apply to trusted sideband connections.","type":"object","properties":{"allowed_client_events":{"description":"Client event types that the frontend data channel may send. Use 'all' to allow every client event; an empty array allows none. Omission preserves the existing allow-all behavior.","oneOf":[{"default":"all","type":"string","enum":["all"]},{"type":"array","items":{"description":"A Live client event type allowed on the frontend data channel, such as `session.input_audio.mute`.","type":"string","minLength":1,"maxLength":256,"pattern":"^(?:error|info|[a-z][a-z0-9_-]*(?:\\.[a-z0-9_-]+)+)$"},"maxItems":256}]},"allowed_server_events":{"description":"Server events that may be sent to the frontend data channel. Use 'all' to allow every server event; an empty array allows none. Omission preserves the existing allow-all behavior. Responses events use an object with type 'response.event' and a response_event selector.","oneOf":[{"default":"all","type":"string","enum":["all"]},{"type":"array","items":{"$ref":"#/definitions/LiveAllowedServerEventParam"},"maxItems":256}]}},"required":[]},"LiveSIPTrunkAuth":{"type":"object","description":"Credentials for SIP Digest authentication with your trunk provider.","properties":{"type":{"type":"string","description":"Use `digest` for SIP Digest authentication. Handles 401 and 407 challenges.","enum":["digest"]},"username":{"type":"string","minLength":1,"description":"Provider username. Must contain a non-whitespace character, be at most 256 bytes, and contain no CR, LF, or NUL."},"password":{"type":"string","minLength":1,"description":"Provider password. Must be at most 4096 bytes and contain no CR, LF, or NUL."}},"required":["type","username","password"],"additionalProperties":false},"LiveCustomVoiceParam":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128}},"required":["id"]},"LiveResponsesDelegationSettingsInputParam":{"description":"Model, prompt, and tool settings for tasks delegated by the Live session to a Responses backend.","type":"object","properties":{"model":{"description":"The model used for server-owned Responses delegations.","type":"string"},"instructions":{"anyOf":[{"description":"Instructions for the delegated Responses model, separate from Live instructions. See [backend prompting](https://developers.openai.com/api/docs/guides/live-delegation#start-with-your-existing-backend-prompt).","type":"string"},{"type":"null"}]},"max_output_tokens":{"anyOf":[{"description":"Maximum number of output tokens for each delegated response.","type":"integer","minimum":16},{"type":"null"}]},"service_tier":{"anyOf":[{"$ref":"#/definitions/LiveResponsesServiceTier"},{"type":"null"}]},"reasoning":{"anyOf":[{"$ref":"#/definitions/LiveDelegationReasoningInputParam"},{"type":"null"}]},"text":{"anyOf":[{"$ref":"#/definitions/LiveDelegationTextInputParam"},{"type":"null"}]},"tools":{"description":"Tools available to the Responses backend while it handles tasks delegated by the Live model.","type":"array","items":{"oneOf":[{"$ref":"#/definitions/LiveFunctionToolInputParam"},{"$ref":"#/definitions/LiveWebSearchToolInputParam"},{"$ref":"#/definitions/LiveFileSearchToolInputParam"},{"$ref":"#/definitions/LiveCodeInterpreterToolInputParam"},{"$ref":"#/definitions/LiveHostedShellToolInputParam"},{"$ref":"#/definitions/LiveImageGenerationToolInputParam"},{"$ref":"#/definitions/LiveMCPToolInputParam"},{"$ref":"#/definitions/LiveCustomToolInputParam"},{"$ref":"#/definitions/LiveNamespaceToolInputParam"},{"$ref":"#/definitions/LiveToolSearchToolInputParam"},{"$ref":"#/definitions/LiveProgrammaticToolInputParam"},{"$ref":"#/definitions/LiveComputerToolInputParam"},{"$ref":"#/definitions/LiveApplyPatchToolInputParam"}]}},"tool_choice":{"description":"Controls which tool the Responses backend uses when handling a task delegated by the Live model.","oneOf":[{"$ref":"#/definitions/LiveToolChoiceEnum"},{"oneOf":[{"$ref":"#/definitions/LiveFunctionToolChoiceParam"},{"$ref":"#/definitions/LiveMCPToolChoiceParam"},{"$ref":"#/definitions/LiveSpecificFileSearchParam"},{"$ref":"#/definitions/LiveSpecificWebSearchParam"},{"$ref":"#/definitions/LiveSpecificWebSearchPreviewParam"},{"$ref":"#/definitions/LiveSpecificImageGenParam"},{"$ref":"#/definitions/LiveSpecificComputerParam"},{"$ref":"#/definitions/LiveSpecificCodeInterpreterParam"},{"$ref":"#/definitions/LiveSpecificProgrammaticToolCallingParam"},{"$ref":"#/definitions/LiveSpecificFunctionShellParam"},{"$ref":"#/definitions/LiveSpecificCustomToolParam"},{"$ref":"#/definitions/LiveSpecificApplyPatchParam"}]},{"$ref":"#/definitions/LiveAllowedToolsChoiceParam"}]},"parallel_tool_calls":{"anyOf":[{"description":"Whether the delegated Responses model may request multiple tool calls in a single response.","type":"boolean"},{"type":"null"}]}},"required":["model"]},"LiveDecisionsSettingsInputParam":{"type":"object","properties":{"questions":{"description":"Native Decision API questions evaluated together, in order.","type":"array","items":{"$ref":"#/definitions/LiveDecisionQuestion"},"minItems":1,"maxItems":64},"model":{"type":"string","minLength":1}},"required":["questions","model"]},"LiveDecisionQuestionsInputParam":{"description":"Questions evaluated using the current transcript and the session's shared Decision items.","type":"object","properties":{"questions":{"description":"Native Decision API questions evaluated together, in order.","type":"array","items":{"$ref":"#/definitions/LiveDecisionQuestion"},"minItems":1,"maxItems":64}},"required":["questions"]},"LiveInitialDeveloperMessageItemParam":{"description":"A developer message included in the initial text history of a Live session.","type":"object","properties":{"id":{"anyOf":[{"description":"An optional identifier for the supplied history message. Live uses the message’s role and text to initialize the conversation.","type":"string"},{"type":"null"}]},"type":{"description":"The history item type. Always `message`.","default":"message","type":"string","enum":["message"]},"status":{"anyOf":[{"$ref":"#/definitions/LiveInitialMessageStatus"},{"type":"null"}]},"role":{"description":"The author of this history message. Always `developer`.","default":"developer","type":"string","enum":["developer"]},"content":{"description":"The message content. Supply exactly one text part for the initial Live conversation history.","type":"array","items":{"$ref":"#/definitions/LiveInitialInputTextContentPartParam"},"minItems":1,"maxItems":1}},"required":["role","content"]},"LiveInitialUserMessageItemParam":{"description":"A user message included in the initial text history of a Live session.","type":"object","properties":{"id":{"anyOf":[{"description":"An optional identifier for the supplied history message. Live uses the message’s role and text to initialize the conversation.","type":"string"},{"type":"null"}]},"type":{"description":"The history item type. Always `message`.","default":"message","type":"string","enum":["message"]},"status":{"anyOf":[{"$ref":"#/definitions/LiveInitialMessageStatus"},{"type":"null"}]},"role":{"description":"The author of this history message. Always `user`.","default":"user","type":"string","enum":["user"]},"content":{"description":"The message content. Supply exactly one text part for the initial Live conversation history.","type":"array","items":{"$ref":"#/definitions/LiveInitialInputTextContentPartParam"},"minItems":1,"maxItems":1}},"required":["role","content"]},"LiveInitialAssistantMessageItemParam":{"description":"An assistant message included in the initial text history of a Live session.","type":"object","properties":{"id":{"anyOf":[{"description":"An optional identifier for the supplied history message. Live uses the message’s role and text to initialize the conversation.","type":"string"},{"type":"null"}]},"type":{"description":"The history item type. Always `message`.","default":"message","type":"string","enum":["message"]},"status":{"anyOf":[{"$ref":"#/definitions/LiveInitialMessageStatus"},{"type":"null"}]},"role":{"description":"The author of this history message. Always `assistant`.","default":"assistant","type":"string","enum":["assistant"]},"content":{"description":"The message content. Supply exactly one text part for the initial Live conversation history.","type":"array","items":{"oneOf":[{"$ref":"#/definitions/LiveInitialTextContentPartParam"},{"$ref":"#/definitions/LiveInitialOutputTextContentPartParam"}]},"minItems":1,"maxItems":1}},"required":["role","content"]},"LiveAllowedServerEventParam":{"description":"A Live server event selector for the WebRTC frontend data channel.","type":"object","properties":{"type":{"description":"The outer Live server event type. Use 'response.event' for Responses events.","type":"string","minLength":1,"maxLength":256},"response_event":{"description":"The nested Responses event type. Required when type is 'response.event'; forbidden for other event types.","type":"string","minLength":1,"maxLength":256}},"required":["type"],"additionalProperties":false,"examples":[{"type":"session.started"}]},"LiveResponsesServiceTier":{"type":"string","enum":["auto","default","fast_tier_temp_pilot","flex","priority","ultrafast"]},"LiveDelegationReasoningInputParam":{"description":"Reasoning options for Responses requests made on behalf of the Live session.","type":"object","properties":{"effort":{"anyOf":[{"$ref":"#/definitions/LiveReasoningEffort"},{"type":"null"}]},"summary":{"anyOf":[{"$ref":"#/definitions/LiveReasoningSummary"},{"type":"null"}]}},"required":[]},"LiveDelegationTextInputParam":{"description":"Text generation options for the Live session’s Responses backend.","type":"object","properties":{"verbosity":{"anyOf":[{"$ref":"#/definitions/LiveTextVerbosity"},{"type":"null"}]}},"required":[]},"LiveFunctionToolInputParam":{"description":"A function tool available to the Responses backend when the Live model delegates a task.","type":"object","properties":{"type":{"description":"The tool type. Always `function`.","default":"function","type":"string","enum":["function"]},"name":{"description":"The name the delegated Responses model uses when calling this function.","type":"string"},"description":{"anyOf":[{"description":"What the function does and when the delegated Responses model should call it.","type":"string"},{"type":"null"}]},"parameters":{"anyOf":[{"description":"A JSON Schema object describing the arguments accepted by the function.","type":"object","additionalProperties":{}},{"type":"null"}]},"strict":{"anyOf":[{"description":"Whether the delegated Responses model must follow the function’s parameter schema exactly.","type":"boolean"},{"type":"null"}]}},"required":["type","name"]},"LiveWebSearchToolInputParam":{"description":"A web search tool available to the Live session’s Responses backend.","type":"object","properties":{"type":{"description":"The tool type. Always `web_search`.","default":"web_search","type":"string","enum":["web_search"]}},"required":["type"]},"LiveFileSearchToolInputParam":{"type":"object","properties":{"type":{"default":"file_search","type":"string","enum":["file_search"]}},"required":["type"]},"LiveCodeInterpreterToolInputParam":{"type":"object","properties":{"type":{"default":"code_interpreter","type":"string","enum":["code_interpreter"]}},"required":["type"]},"LiveHostedShellToolInputParam":{"description":"A Responses shell tool. Use a hosted container or return local shell results with response.item.create. Domain secrets are not supported.","type":"object","properties":{"type":{"default":"shell","type":"string","enum":["shell"]},"environment":{"anyOf":[{"oneOf":[{"$ref":"#/definitions/LiveHostedShellContainerAutoParam"},{"$ref":"#/definitions/LiveContainerReferenceParam"},{"$ref":"#/definitions/LiveLocalEnvironmentParam"}]},{"type":"null"}]}},"required":["type"]},"LiveImageGenerationToolInputParam":{"type":"object","properties":{"type":{"default":"image_generation","type":"string","enum":["image_generation"]}},"required":["type"]},"LiveMCPToolInputParam":{"type":"object","properties":{"type":{"default":"mcp","type":"string","enum":["mcp"]}},"required":["type"]},"LiveCustomToolInputParam":{"type":"object","properties":{"type":{"default":"custom","type":"string","enum":["custom"]}},"required":["type"]},"LiveNamespaceToolInputParam":{"type":"object","properties":{"type":{"default":"namespace","type":"string","enum":["namespace"]}},"required":["type"]},"LiveToolSearchToolInputParam":{"type":"object","properties":{"type":{"default":"tool_search","type":"string","enum":["tool_search"]}},"required":["type"]},"LiveProgrammaticToolInputParam":{"type":"object","properties":{"type":{"default":"programmatic_tool_calling","type":"string","enum":["programmatic_tool_calling"]}},"required":["type"]},"LiveComputerToolInputParam":{"type":"object","properties":{"type":{"default":"computer","type":"string","enum":["computer"]}},"required":["type"]},"LiveApplyPatchToolInputParam":{"type":"object","properties":{"type":{"default":"apply_patch","type":"string","enum":["apply_patch"]}},"required":["type"]},"LiveToolChoiceEnum":{"type":"string","enum":["auto","none","required"]},"LiveFunctionToolChoiceParam":{"type":"object","properties":{"type":{"description":"The tool to call. Always `function`.","default":"function","type":"string","enum":["function"]},"name":{"description":"The name of the function tool to call.","type":"string"}},"required":["type","name"]},"LiveMCPToolChoiceParam":{"type":"object","properties":{"type":{"description":"The tool to call. Always `mcp`.","default":"mcp","type":"string","enum":["mcp"]},"server_label":{"description":"The label of the MCP server to call.","type":"string"},"name":{"anyOf":[{"description":"The name of the MCP tool to call. If omitted, the server may choose a default.","type":"string"},{"type":"null"}]}},"required":["type","server_label"]},"LiveSpecificFileSearchParam":{"type":"object","properties":{"type":{"description":"The tool to call. Always `file_search`.","default":"file_search","type":"string","enum":["file_search"]}},"required":["type"]},"LiveSpecificWebSearchParam":{"type":"object","properties":{"type":{"description":"The tool to call. Always `web_search`.","default":"web_search","type":"string","enum":["web_search"]}},"required":["type"]},"LiveSpecificWebSearchPreviewParam":{"type":"object","properties":{"type":{"description":"The tool to call. Always `web_search_preview`.","default":"web_search_preview","type":"string","enum":["web_search_preview"]}},"required":["type"]},"LiveSpecificImageGenParam":{"type":"object","properties":{"type":{"description":"The tool to call. Always `image_generation`.","default":"image_generation","type":"string","enum":["image_generation"]}},"required":["type"]},"LiveSpecificComputerParam":{"type":"object","properties":{"type":{"description":"The tool to call. Always `computer`.","default":"computer","type":"string","enum":["computer"]}},"required":["type"]},"LiveSpecificCodeInterpreterParam":{"type":"object","properties":{"type":{"description":"The tool to call. Always `code_interpreter`.","default":"code_interpreter","type":"string","enum":["code_interpreter"]}},"required":["type"]},"LiveSpecificProgrammaticToolCallingParam":{"type":"object","properties":{"type":{"description":"The tool to call. Always `programmatic_tool_calling`.","default":"programmatic_tool_calling","type":"string","enum":["programmatic_tool_calling"]}},"required":["type"]},"LiveSpecificFunctionShellParam":{"title":"Specific shell tool choice","description":"Forces the model to call the shell tool when a tool call is required.","type":"object","properties":{"type":{"description":"The tool to call. Always `shell`.","default":"shell","type":"string","enum":["shell"]}},"required":["type"]},"LiveSpecificCustomToolParam":{"type":"object","properties":{"type":{"description":"The tool to call. Always `custom`.","default":"custom","type":"string","enum":["custom"]},"name":{"description":"The name of the custom tool to call.","type":"string"}},"required":["type","name"]},"LiveSpecificApplyPatchParam":{"title":"Specific apply patch tool choice","description":"Forces the model to call the apply_patch tool when executing a tool call.","type":"object","properties":{"type":{"description":"The tool to call. Always `apply_patch`.","default":"apply_patch","type":"string","enum":["apply_patch"]}},"required":["type"]},"LiveAllowedToolsChoiceParam":{"type":"object","properties":{"type":{"description":"The tool choice type. Always `allowed_tools`.","default":"allowed_tools","type":"string","enum":["allowed_tools"]},"tools":{"description":"The tools that the delegated Responses model may call.","type":"array","items":{"oneOf":[{"$ref":"#/definitions/LiveFunctionToolChoiceParam"},{"$ref":"#/definitions/LiveMCPToolChoiceParam"},{"$ref":"#/definitions/LiveSpecificFileSearchParam"},{"$ref":"#/definitions/LiveSpecificWebSearchParam"},{"$ref":"#/definitions/LiveSpecificWebSearchPreviewParam"},{"$ref":"#/definitions/LiveSpecificImageGenParam"},{"$ref":"#/definitions/LiveSpecificComputerParam"},{"$ref":"#/definitions/LiveSpecificCodeInterpreterParam"},{"$ref":"#/definitions/LiveSpecificProgrammaticToolCallingParam"},{"$ref":"#/definitions/LiveSpecificFunctionShellParam"},{"$ref":"#/definitions/LiveSpecificCustomToolParam"},{"$ref":"#/definitions/LiveSpecificApplyPatchParam"}]},"minItems":1,"maxItems":128},"mode":{"anyOf":[{"$ref":"#/definitions/LiveToolChoiceValueEnum"},{"type":"null"}]}},"required":["type","tools"]},"LiveDecisionQuestion":{"oneOf":[{"$ref":"#/definitions/LiveDecisionChoiceQuestionParam"},{"$ref":"#/definitions/LiveDecisionPredicateQuestionParam"},{"$ref":"#/definitions/LiveDecisionScoreQuestionParam"}]},"LiveInitialMessageStatus":{"type":"string","enum":["incomplete","completed"]},"LiveInitialInputTextContentPartParam":{"description":"Text supplied in a developer or user message when starting a Live session.","type":"object","properties":{"type":{"description":"The text content type. Always `input_text`.","default":"input_text","type":"string","enum":["input_text"]},"text":{"description":"The message text to include in the Live session’s initial conversation history.","type":"string"}},"required":["text"]},"LiveInitialTextContentPartParam":{"description":"Assistant text supplied as conversation history when starting a Live session.","type":"object","properties":{"type":{"description":"The text content type. Always `text`.","default":"text","type":"string","enum":["text"]},"text":{"description":"The message text to include in the Live session’s initial conversation history.","type":"string"}},"required":["text"]},"LiveInitialOutputTextContentPartParam":{"description":"Assistant output text supplied as conversation history when starting a Live session.","type":"object","properties":{"type":{"description":"The text content type. Always `output_text`.","default":"output_text","type":"string","enum":["output_text"]},"text":{"description":"The message text to include in the Live session’s initial conversation history.","type":"string"}},"required":["type","text"]},"LiveReasoningEffort":{"type":"string","enum":["none","minimal","low","medium","high","xhigh"]},"LiveReasoningSummary":{"type":"string","enum":["concise","detailed","auto"]},"LiveTextVerbosity":{"type":"string","enum":["low","medium","high"]},"LiveHostedShellContainerAutoParam":{"type":"object","properties":{"type":{"description":"Automatically creates a container for this request","default":"container_auto","type":"string","enum":["container_auto"]},"file_ids":{"anyOf":[{"description":"An optional list of uploaded files to make available to your code.","type":"array","items":{"type":"string"},"maxItems":50},{"type":"null"}]},"memory_limit":{"anyOf":[{"$ref":"#/definitions/LiveContainerMemoryLimit"},{"type":"null"}]},"network_policy":{"anyOf":[{"description":"Network access policy for the container.","oneOf":[{"$ref":"#/definitions/LiveContainerNetworkPolicyDisabledParam"},{"$ref":"#/definitions/LiveHostedShellNetworkPolicyAllowlistParam"}]},{"type":"null"}]},"skills":{"anyOf":[{"description":"An optional list of skills referenced by id or inline data.","type":"array","items":{"oneOf":[{"$ref":"#/definitions/LiveSkillReferenceParam"},{"$ref":"#/definitions/LiveInlineSkillParam"}]},"maxItems":200},{"type":"null"}]}},"required":["type"]},"LiveContainerReferenceParam":{"type":"object","properties":{"type":{"description":"References a container created with the /v1/containers endpoint","default":"container_reference","type":"string","enum":["container_reference"]},"container_id":{"description":"The ID of the referenced container.","type":"string"}},"required":["type","container_id"]},"LiveLocalEnvironmentParam":{"type":"object","properties":{"type":{"description":"Use a local computer environment.","default":"local","type":"string","enum":["local"]},"skills":{"anyOf":[{"description":"An optional list of skills.","type":"array","items":{"$ref":"#/definitions/LiveLocalSkillParam"},"maxItems":200},{"type":"null"}]}},"required":["type"]},"LiveToolChoiceValueEnum":{"type":"string","enum":["none","auto","required"]},"LiveDecisionChoiceQuestionParam":{"type":"object","properties":{"type":{"default":"choice","type":"string","enum":["choice"]},"name":{"type":"string"},"instructions":{"oneOf":[{"type":"string"},{"type":"array","items":{"oneOf":[{"$ref":"#/definitions/LiveDecisionInputTextParam"},{"$ref":"#/definitions/LiveDecisionInputImageParam"},{"$ref":"#/definitions/LiveDecisionInputJsonParam"}]},"minItems":1}]},"choices":{"type":"array","items":{"$ref":"#/definitions/LiveDecisionChoiceParam"},"minItems":2,"maxItems":255}},"required":["type","instructions","choices"]},"LiveDecisionPredicateQuestionParam":{"type":"object","properties":{"type":{"default":"predicate","type":"string","enum":["predicate"]},"name":{"type":"string"},"instructions":{"oneOf":[{"type":"string"},{"type":"array","items":{"oneOf":[{"$ref":"#/definitions/LiveDecisionInputTextParam"},{"$ref":"#/definitions/LiveDecisionInputImageParam"},{"$ref":"#/definitions/LiveDecisionInputJsonParam"}]},"minItems":1}]}},"required":["type","instructions"]},"LiveDecisionScoreQuestionParam":{"type":"object","properties":{"type":{"default":"score","type":"string","enum":["score"]},"name":{"type":"string"},"instructions":{"oneOf":[{"type":"string"},{"type":"array","items":{"oneOf":[{"$ref":"#/definitions/LiveDecisionInputTextParam"},{"$ref":"#/definitions/LiveDecisionInputImageParam"},{"$ref":"#/definitions/LiveDecisionInputJsonParam"}]},"minItems":1}]},"levels":{"type":"array","items":{"$ref":"#/definitions/LiveDecisionScoreLevelParam"},"minItems":2,"maxItems":10}},"required":["type","instructions","levels"]},"LiveContainerMemoryLimit":{"type":"string","enum":["1g","4g","16g","64g"]},"LiveContainerNetworkPolicyDisabledParam":{"type":"object","properties":{"type":{"description":"Disable outbound network access. Always `disabled`.","default":"disabled","type":"string","enum":["disabled"]}},"required":["type"]},"LiveHostedShellNetworkPolicyAllowlistParam":{"type":"object","properties":{"type":{"description":"Allow outbound network access only to specified domains. Always `allowlist`.","default":"allowlist","type":"string","enum":["allowlist"]},"allowed_domains":{"description":"A list of allowed domains when type is `allowlist`.","type":"array","items":{"type":"string"},"minItems":1}},"required":["type","allowed_domains"]},"LiveSkillReferenceParam":{"type":"object","properties":{"type":{"description":"References a skill created with the /v1/skills endpoint.","default":"skill_reference","type":"string","enum":["skill_reference"]},"skill_id":{"description":"The ID of the referenced skill.","type":"string","minLength":1,"maxLength":64},"version":{"anyOf":[{"description":"Optional skill version. Use a positive integer or 'latest'. Omit for default.","type":"string"},{"type":"null"}]}},"required":["type","skill_id"]},"LiveInlineSkillParam":{"type":"object","properties":{"type":{"description":"Defines an inline skill for this request.","default":"inline","type":"string","enum":["inline"]},"name":{"description":"The name of the skill.","type":"string"},"description":{"description":"The description of the skill.","type":"string"},"source":{"$ref":"#/definitions/LiveInlineSkillSourceParam"}},"required":["type","name","description","source"]},"LiveLocalSkillParam":{"type":"object","properties":{"name":{"description":"The name of the skill.","type":"string"},"description":{"description":"The description of the skill.","type":"string"},"path":{"description":"The path to the directory containing the skill.","type":"string"}},"required":["name","description","path"]},"LiveDecisionInputTextParam":{"type":"object","properties":{"type":{"default":"input_text","type":"string","enum":["input_text"]},"text":{"description":"The text input to the model.","type":"string","maxLength":10485760}},"required":["type","text"]},"LiveDecisionInputImageParam":{"type":"object","properties":{"type":{"default":"input_image","type":"string","enum":["input_image"]},"image_url":{"description":"A base64-encoded image data URL or a publicly accessible HTTP(S) image URL.","type":"string","maxLength":20971520,"pattern":"^(data:|https?://)"},"detail":{"anyOf":[{"$ref":"#/definitions/LiveDetailEnum"},{"type":"null"}]}},"required":["type","image_url"]},"LiveDecisionInputJsonParam":{"type":"object","properties":{"type":{"default":"input_json","type":"string","enum":["input_json"]},"data":{"oneOf":[{"$ref":"#/definitions/LiveDecisionJsonObject"},{"type":"array","items":{"$ref":"#/definitions/LiveDecisionJsonObject"}}]}},"required":["type","data"]},"LiveDecisionChoiceParam":{"type":"object","properties":{"value":{"oneOf":[{"type":"string"},{"type":"boolean"}]},"description":{"type":"string"}},"required":["value"]},"LiveDecisionScoreLevelParam":{"type":"object","properties":{"label":{"type":"string"},"description":{"type":"string"}},"required":["label"]},"LiveInlineSkillSourceParam":{"description":"Inline skill payload","type":"object","properties":{"type":{"description":"The type of the inline skill source. Must be `base64`.","default":"base64","type":"string","enum":["base64"]},"media_type":{"description":"The media type of the inline skill payload. Must be `application/zip`.","default":"application/zip","type":"string","enum":["application/zip"]},"data":{"description":"Base64-encoded skill zip bundle.","type":"string","minLength":1,"maxLength":70254592}},"required":["type","media_type","data"]},"LiveDetailEnum":{"type":"string","enum":["low","high","auto","original"]},"LiveDecisionJsonObject":{"type":"object","additionalProperties":true}}},"name":"Create session","id":"openai.create-live","example":{"body":{"session":{"model":"gpt-live-1"},"transport":{"type":"webrtc","sdp":"example"}}},"maxRequests":1,"summary":false}}