curl -X POST 'https://api.openai.com/v1/live/sessions' \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "session": {
    "model": "gpt-live-1",
    "instructions": "example-instructions",
    "audio": {
      "output": {
        "voice": "example-voice"
      }
    },
    "delegation": {
      "type": "client"
    },
    "triggers": [
      {
        "type": "decisions",
        "event_type": "session.input_transcript.delta",
        "decisions": {
          "questions": [
            {
              "type": "[recursive or deeply nested schema]",
              "name": "[recursive or deeply nested schema]",
              "instructions": "[recursive or deeply nested schema]",
              "choices": "[recursive or deeply nested schema]"
            }
          ]
        }
      }
    ],
    "store": true,
    "input": [
      {
        "id": "example-id",
        "type": "message",
        "status": "incomplete",
        "role": "developer",
        "content": [
          {
            "type": "input_text",
            "text": "example-text"
          }
        ]
      }
    ],
    "client": {
      "data_channel": {
        "allowed_client_events": "all",
        "allowed_server_events": "all"
      }
    }
  },
  "transport": {
    "type": "webrtc",
    "sdp": "example-sdp"
  }
}'

# POST /live/sessions (OpenAI API)
Base URL: https://api.openai.com/v1
Auth: Authorization; OpenAI API key; required.
Request formats: application/json.
Last verified: 2026-10-20

> Create session

## Critical Gotchas
* The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.
* Audio transcription uploads use multipart form data rather than a JSON request body.

## cURL
curl -X POST 'https://api.openai.com/v1/live/sessions' \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "session": {
    "model": "gpt-live-1",
    "instructions": "example-instructions",
    "audio": {
      "output": {
        "voice": "example-voice"
      }
    },
    "delegation": {
      "type": "client"
    },
    "triggers": [
      {
        "type": "decisions",
        "event_type": "session.input_transcript.delta",
        "decisions": {
          "questions": [
            {
              "type": "[recursive or deeply nested schema]",
              "name": "[recursive or deeply nested schema]",
              "instructions": "[recursive or deeply nested schema]",
              "choices": "[recursive or deeply nested schema]"
            }
          ]
        }
      }
    ],
    "store": true,
    "input": [
      {
        "id": "example-id",
        "type": "message",
        "status": "incomplete",
        "role": "developer",
        "content": [
          {
            "type": "input_text",
            "text": "example-text"
          }
        ]
      }
    ],
    "client": {
      "data_channel": {
        "allowed_client_events": "all",
        "allowed_server_events": "all"
      }
    }
  },
  "transport": {
    "type": "webrtc",
    "sdp": "example-sdp"
  }
}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| session | body | object | Yes | Startup configuration for a Live media session. Follow the [Live prompting gu... |
| transport | body | object | Yes | WebRTC transport with an SDP offer, or SIP transport with a destination and p... |

## Response example
{"session":{"id":"string"},"transport":{"type":"webrtc","sdp":"string"}}

---
Need an API key? Get one at https://platform.openai.com/api-keys

POST

POST /live/sessions — OpenAI API

OpenAI API key (required); https://api.openai.com/v1

OpenAI API

Create session

Base URL: https://api.openai.com/v1
Auth: Authorization: Bearer <OPENAI_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 345 tokens · Vary: Accept

Critical gotchas

The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.

Audio transcription uploads use multipart form data rather than a JSON request body.

cURL

curl -X POST 'https://api.openai.com/v1/live/sessions' \  -H "Authorization: Bearer $OPENAI_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "session": {    "model": "gpt-live-1",    "instructions": "example-instructions",    "audio": {      "output": {        "voice": "example-voice"      }    },    "delegation": {      "type": "client"    },    "triggers": [      {        "type": "decisions",        "event_type": "session.input_transcript.delta",        "decisions": {          "questions": [            {              "type": "[recursive or deeply nested schema]",              "name": "[recursive or deeply nested schema]",              "instructions": "[recursive or deeply nested schema]",              "choices": "[recursive or deeply nested schema]"            }          ]        }      }    ],    "store": true,    "input": [      {        "id": "example-id",        "type": "message",        "status": "incomplete",        "role": "developer",        "content": [          {            "type": "input_text",            "text": "example-text"          }        ]      }    ],    "client": {      "data_channel": {        "allowed_client_events": "all",        "allowed_server_events": "all"      }    }  },  "transport": {    "type": "webrtc",    "sdp": "example-sdp"  }}'

Parameters

Name	In	Type	Required	Description
session	body	object	Yes	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.
transport	body	object	Yes	WebRTC transport with an SDP offer, or SIP transport with a destination and per-call trunk credentials.

Response 200 OK

{
  "session": {
    "id": "string"
  },
  "transport": {
    "type": "webrtc",
    "sdp": "string"
  }
}

Get a free OpenAI API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.