Get Session URL

Resolve a gateway URL for a port exposed by the sandbox session. For browser sessions, omit port or set it to 9222 to get the browser proxy base URL; then use that URL directly with a CDP client such as Playwright/Puppeteer or append /json/version to inspect the browser endpoint over plain HTTP.

GET /api/v1/sandbox/sessions/{session_id}/url

Python (SDK)

Python

from mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.sandbox.get_url(session_id="demo-python-20260316", session_token="sandbox_test_20260316_4f9c2b1a", port=8003)

    # Handle response
    print(res)

200

{
  "session_id": "demo-python-20260316",
  "url": "http://10.0.3.19:8010/v1/sandboxes/demo-python-20260316"
}

Authorizations

Authorization · string · header · required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of · string

Optional external end-user identifier forwarded by the API gateway.

Path Parameters

session_id · string · required

Query Parameters

session_token · string | null

port · integer | null

Response

200

application/json

Successful Response

session_id · string · required

url · string · required