---
title: "Start device traffic inspection"
method: POST
path: "/devices/{deviceId}/traffic/sessions"
tags: ["Device Traffic"]
---

# Start device traffic inspection

`POST /devices/{deviceId}/traffic/sessions`

## Request

- Base URL: `https://api.mobilerun.ai`
- URL: `https://api.mobilerun.ai/devices/{deviceId}/traffic/sessions`
- Auth: HTTP bearer

Starts one live-only decoded HTTP/1.1, HTTP/2, HTTP/3 and WebSocket traffic session.

## Path parameters

- `deviceId` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateSessionBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `expiresInSeconds` integer
  - `maxBodyBytes` integer

## Response `202`

Accepted

- Session
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `createdAt` string, date-time, required
  - `deviceId` string, required
  - `error` SessionError
    - `code` string, required
    - `message` string, required
  - `expiresAt` string, date-time, required
  - `id` string, required
  - `maxBodyBytes` integer, required
  - `retention` 'none', required
  - `startedAt` string, date-time
  - `state` 'starting' | 'active' | 'stopping' | 'stopped' | 'failed' | 'expired', required
  - `stoppedAt` string, date-time
  - `stream` StreamCredentials
    - `protocol` string, required
    - `token` string, required
    - `url` string, required

## Other responses

- `default`: Error

## Changes

- **2026-10-16** `4ad548c528a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/devices/:deviceId/traffic/sessions/post.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) - [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/droidrun/apis/droidrun-cloud/revisions/1cc95586c933?raw)