Use saved proxies by name and session ID

{
  "name": "Research browser",
  "settings": {
    "pool": "residential",
    "country": "US",
    "rotation": "auto10",
    "protocol": "http",
    "ttl_seconds": 600
  }
}

curl --fail --request POST "$PORTPROOF_API_URL/traffic/connections" \
  -H "Authorization: Bearer $PORTPROOF_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @connection.json

# PORTPROOF_API_URL includes /v1; use your customer API key.
# Choose ONE exact lookup. Names are case-sensitive and may match several records.
curl --fail --get "$PORTPROOF_API_URL/traffic/connections" \
  -H "Authorization: Bearer $PORTPROOF_API_KEY" \
  --data-urlencode "name=$PROXY_NAME"

# Or find the current saved configuration by its server-allocated SID.
curl --fail --get "$PORTPROOF_API_URL/traffic/connections" \
  -H "Authorization: Bearer $PORTPROOF_API_KEY" \
  --data-urlencode "sid=$PROXY_SID"
# Keep the chosen record's id. Never silently select the first duplicate name.

import { ProxyAgent, fetch as proxyFetch } from 'undici';

async function main() {
  // Set PORTPROOF_API_URL (including /v1), PORTPROOF_API_KEY,
  // and exactly one of PROXY_CONNECTION_ID, PROXY_NAME or PROXY_SID.
  const API = process.env.PORTPROOF_API_URL.replace(/\/$/, '');
  const selectors = ['PROXY_CONNECTION_ID', 'PROXY_NAME', 'PROXY_SID']
    .filter((key) => process.env[key]);
  if (selectors.length !== 1) throw new Error('Choose one saved configuration selector');

  async function api(path, method = 'GET') {
    const response = await fetch(API + path, {
      method,
      headers: { authorization: 'Bearer ' + process.env.PORTPROOF_API_KEY,
        'content-type': 'application/json' },
      ...(method === 'POST' ? { body: '{}' } : {}),
      redirect: 'error', signal: AbortSignal.timeout(15000), cache: 'no-store',
    });
    // Do not print response bodies or nested errors: they may contain credentials.
    if (!response.ok) throw new Error('Portproof API status ' + response.status);
    return response.json();
  }

  let id = process.env.PROXY_CONNECTION_ID;
  if (!id) {
    const query = new URLSearchParams(process.env.PROXY_NAME
      ? { name: process.env.PROXY_NAME } : { sid: process.env.PROXY_SID });
    const { connections } = await api('/traffic/connections?' + query);
    if (connections.length !== 1) {
      throw new Error('No unique match: inspect saved configurations and choose an ID');
    }
    id = connections[0].id;
  }
  const path = '/traffic/connections/' + encodeURIComponent(id);
  const saved = await api(path);
  if (saved.settings.protocol !== 'http') throw new Error('Choose an HTTP configuration');
  const exported = await api(path + '/export', 'POST');
  if (exported.configuration_version !== saved.version || exported.session !== saved.sid) {
    throw new Error('Configuration changed: review its current version before reconnecting');
  }

  // Use the exact saved export in memory. Never print or commit exported.url.
  const dispatcher = new ProxyAgent(exported.url);
  try {
    const response = await proxyFetch('https://example.com/', {
      dispatcher, redirect: 'manual', signal: AbortSignal.timeout(20000),
    });
    console.log({ status: response.status });
    await response.body?.cancel();
  } finally {
    await dispatcher.close();
  }
}

// Covers control requests, JSON parsing, agent construction and cleanup as well.
await main().catch(() => {
  console.error('Saved proxy check failed; review the configuration and API state');
  process.exitCode = 1;
});

# pip install 'requests[socks]'
import os
from urllib.parse import quote
import requests

api = os.environ["PORTPROOF_API_URL"].rstrip("/")  # includes /v1
connection_id = quote(os.environ["PROXY_CONNECTION_ID"], safe="")
path = f"{api}/traffic/connections/{connection_id}"

try:
    with requests.Session() as control:
        control.trust_env = False
        control.headers["Authorization"] = "Bearer " + os.environ["PORTPROOF_API_KEY"]
        saved_response = control.get(path, timeout=(5, 15), allow_redirects=False)
        if saved_response.status_code != 200:
            raise ValueError("Saved configuration unavailable")
        saved = saved_response.json()
        if saved["settings"]["protocol"] != "socks5":
            raise ValueError("Choose a saved SOCKS5 configuration")
        response = control.post(path + "/export", json={}, timeout=(5, 15), allow_redirects=False)
        if response.status_code != 200:
            raise ValueError("Export unavailable; review the dashboard state")
        exported = response.json()
    if exported["configuration_version"] != saved["version"] or exported["session"] != saved["sid"]:
        raise ValueError("Configuration changed; review its current version")
    # socks5h keeps destination DNS at the proxy. Preserve all saved routing tokens.
    proxy = exported["url"].replace("socks5://", "socks5h://", 1)
    with requests.Session() as client:
        client.trust_env = False
        with client.get("https://example.com/", proxies={"http": proxy, "https": proxy},
                        timeout=(5, 15), allow_redirects=False, stream=True) as result:
            print("HTTP status:", result.status_code)
except (requests.RequestException, ValueError, KeyError):
    # Do not print exception text, full URLs, headers or exported passwords.
    raise SystemExit("Check failed; inspect the saved configuration diagnostics") from None

# Copy the FULL exported username into PROXY_USERNAME, without altering its SID.
# curl prompts for the password; keep it out of shell history and process arguments.
curl --disable --connect-timeout 10 --max-time 20 \
  --proxy 'http://gw.portproof.org:7000' --proxy-user "$PROXY_USERNAME" \
  --output /dev/null --write-out 'HTTP status: %{http_code}\n' 'https://example.com/'

# For a saved SOCKS5 configuration, use its own exported username and remote DNS.
curl --disable --connect-timeout 10 --max-time 20 \
  --proxy 'socks5h://gw.portproof.org:7001' --proxy-user "$PROXY_USERNAME" \
  --output /dev/null --write-out 'HTTP status: %{http_code}\n' 'https://example.com/'

http://ACCOUNT-POOL-COUNTRY-sid-SAVED_SID-rot-MODE:PASSWORD@gw.portproof.org:7000
socks5://ACCOUNT-POOL-COUNTRY-sid-SAVED_SID-rot-MODE:PASSWORD@gw.portproof.org:7001