Create a new session

Sessions are idempotent, so relevant parameters must be set in this function if desired

Request URL


Basic Authentication

Bandwidth WebRTC API leverages Basic Authentication with your Dashboard API Credentials. Read more about how Bandwidth secures endpoints in the Security & Credentials document.

Request Body Parameters

Parameter Description
tag User defined tag to associate with the session

Response Attributes

Property Description
id Unique id of the session
tag User defined tag to associate with the session

Example: Create a new session

curl -X POST
  --url '{accountId}/sessions'
  -u '{username}:{password}'
  -H 'Content-type: application/json'
     --data-raw '
  "tag": "session1"


  "id"                  : "75c21163-e110-41bc-bd76-1bb428ec85d5",
  "tag"                 : "session1"

Potential Error Responses

HTTP/1.1 400 (Bad Request)
Content-Type: application/json
HTTP/1.1 401 (Unauthorized)
Content-Type: application/json
HTTP/1.1 403 (Access Denied)
Content-Type: application/json
HTTP/1.1 50x (Unexpected Error)
Content-Type: application/json

results matching ""

    No results matching ""