Session duration

✓Residential — supported—Rotating ISP — not supported—Rotating DC — not supported

-duration- sets how many minutes a sticky session keeps its exit.

Usage

curl -x USERNAME:[email protected]:8000 \
  https://api.ipify.org

curl --proxy-header "X-Rayobyte-Session: abc12345" \
     --proxy-header "X-Rayobyte-Duration: 30" \
     -x us-east.gw.rayobyte.com:8000 https://api.ipify.org

Value rules

Minutes, from 1 to 120. Values outside that range are clamped, not rejected: -duration-500 becomes 120 and -duration-0 becomes 1. You get no warning, so if a long job is ending earlier than you expect, check this first.

Without -duration-, the session runs for its default lifetime.

It only applies to sticky sessions

-duration- on its own does nothing. It needs a -session- or -hardsession- to attach to, because there is no IP being held otherwise.

Longer is not better

A residential exit is somebody’s phone or laptop. Asking to hold one for two hours means asking a stranger’s device to stay online and idle-ish for two hours, and the longer you ask, the likelier you are to lose it mid-flow.

Set the duration to roughly how long your flow actually takes, then add a margin. If a checkout takes four minutes, -duration-10 is a better bet than -duration-120. With soft sticky the replacement behavior covers you either way.