Stateful Sessions

Rotate a stateful session

Bind the session to a new exit node now. The response carries the new exit_ip and bound_since. Limited to one rotation per second per session.

Requires the proxy:packages:write scope.

post/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate

Request

Path parameters

package_idstring required

The ID of the proxy package (UUID format)

session_idstring required

The ID of the stateful session (UUID format)

Response

Successful Response

idstring required
proxy_idstring required
namestring required
status'enabled' | 'disabled' required
exit_ipstring required

IP address of the exit node the session is bound to now.

network_typestring required

Network of the bound node. The top-level geo and network fields describe where the session is bound now; ruleset holds what you asked for.

countrystring required
regionstring nullable
citystring nullable
ispstring nullable
asnstring nullable
zipstring nullable
bound_sincestring date-time nullable

When the session was bound to its current node.

portinteger nullable

Gateway port to connect to. IP allowlist packages get a dedicated port per session; credential packages share the gateway port.

created_atstring date-time required
updated_atstring date-time required

Changes

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