---
title: "Set a predefined network profile"
method: POST
path: "/sessions/{sessionId}/network/profile"
tags: ["Network Throttling"]
---

# Set a predefined network profile

`POST /sessions/{sessionId}/network/profile`

## Request

- Base URL: `https://api.us-west-1.saucelabs.com/rdc/v2`
- URL: `https://api.us-west-1.saucelabs.com/rdc/v2/sessions/{sessionId}/network/profile`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/saucelabs/apis/real-device-access-api-reference/docs/sessions/:sessionId/network/profile/post.ts> (a function with typed inputs; its response is checked against the schema)

Applies a predefined network profile (e.g. `2G`, `4G-fast`) to the device session. Profiles are mapped to network conditions internally—the resolved conditions are returned in the response. Use `DELETE /sessions/{sessionId}/network/condition` to reset.

## Path parameters

- `sessionId` string, required

## Request body

- NetworkProfileRequest
  - `networkProfile` string, required: The ID of the predefined network profile to apply.

## Response `200`

Network profile applied successfully

- NetworkConditions: Network condition parameters applied to the device.
  - `downloadSpeed` integer: Download speed in kbps (0 - 50000).
  - `uploadSpeed` integer: Upload speed in kbps (0 - 50000).
  - `latency` integer: Latency in ms (0 - 3000).
  - `loss` integer: Packet loss percentage (0 - 100).

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/saucelabs/apis/real-device-access-api-reference.md) - [All operations](https://skmtc.dev/saucelabs/apis/real-device-access-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/saucelabs/apis/real-device-access-api-reference/revisions/f845a4b66e37?raw)