Session Lifecycle

Allocate a device and create a new session

Creates a new device session. The session runs on a private device or on a public device from the shared Sauce Labs cloud, depending on which devices match your query.

post/sessions

Request

Base URL
https://api.us-west-1.saucelabs.com/rdc/v2
Auth
HTTP basic
TypeScript
https://skmtc.dev/saucelabs/apis/real-device-access-api-reference/docs/sessions/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

Example request

{
  "device": {
    "deviceName": "iPhone_16_real",
    "os": "ios"
  },
  "configuration": {
    "tunnel": {
      "name": "us_west_sauce_connect_tunnel",
      "owner": "some_user_name"
    },
    "sessionDuration": "PT1H"
  },
  "autoStartTest": {
    "testName": "Checkout flow — guest user",
    "build": "build-1042",
    "tags": [
      "smoke",
      "checkout"
    ]
  }
}

Response

idstring

Example response

{
  "state": "CREATING"
}

Changes

No recorded changes to this operation across all 1 revision of this API.