curl --request PATCH \
  --url https://api.usefoil.com/v1/sessions/{sessionId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_user_id": "user_123"
}
'

import requests

url = "https://api.usefoil.com/v1/sessions/{sessionId}"

payload = { "client_user_id": "user_123" }
headers = {"Content-Type": "application/json"}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({client_user_id: 'user_123'})
};

fetch('https://api.usefoil.com/v1/sessions/{sessionId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.usefoil.com/v1/sessions/{sessionId}"

	payload := strings.NewReader("{\n  \"client_user_id\": \"user_123\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.usefoil.com/v1/sessions/{sessionId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"client_user_id\": \"user_123\"\n}"

response = http.request(request)
puts response.read_body

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usefoil.com/v1/sessions/{sessionId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'client_user_id' => 'user_123'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": {
    "object": "session",
    "id": "sid_87wfetm98myh9awj0dpt28a3kc",
    "created_at": "2026-03-24T20:00:00.000Z",
    "client_user_id": "user_123",
    "decision": {
      "event_id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
      "automation_status": "automated",
      "risk_score": 94,
      "evaluation_phase": "snapshot",
      "decision_status": "preliminary",
      "evaluated_at": "2026-03-24T20:00:05.000Z"
    },
    "highlights": [
      {
        "key": "browser_automation",
        "effect": "increases_risk",
        "importance": "high",
        "summary": "Browser is being driven by automation",
        "evidence": [
          {
            "signal": "webdriver_detected",
            "name": "Acme Growth Workspace"
          }
        ]
      }
    ],
    "web_bot_auth": {
      "status": "verified",
      "domain": "browserless.io"
    },
    "network": {
      "ip_address": "203.0.113.10",
      "ip_version": "ipv4",
      "status": "ready",
      "summary": "Browser is being driven by automation",
      "location": {
        "city": "San Francisco",
        "region": "California",
        "country": "United States",
        "country_code": "US",
        "latitude": 37.7749,
        "longitude": -122.4194,
        "timezone": "America/Los_Angeles",
        "postal_code": "94103",
        "accuracy_radius_km": 10
      },
      "routing": {
        "asn": "64512",
        "organization": "SPECTRANET LIMITED"
      },
      "anonymity": {
        "vpn": true,
        "proxy": false,
        "tor": false,
        "relay": false,
        "hosting": false,
        "residential_proxy": false,
        "callback_proxy": false,
        "provider": "Mullvad VPN"
      },
      "reputation": {
        "listed": true,
        "categories": [
          "vpn"
        ],
        "suspicious_network": false
      },
      "evidence": {
        "risk_signals": [
          "vpn"
        ],
        "operator_tags": [
          "vpn"
        ],
        "client_types": [
          "consumer"
        ],
        "client_count": 1
      },
      "evaluated_at": "2026-03-24T20:00:05.000Z"
    },
    "runtime_integrity": {
      "tampering": "high_risk",
      "developer_tools": "high_risk",
      "emulation": "clean",
      "virtualization": "high_risk",
      "privacy_hardening": "notice",
      "identity_spoofing": "clean",
      "replay": "clean",
      "outdated_environment": "clean"
    },
    "native_runtime_integrity": {
      "platform": "ios",
      "jailbreak_or_root": {
        "detected": true,
        "signals": [
          "webdriver_detected"
        ],
        "present_paths": [
          "present_paths"
        ],
        "dyld_insert_libraries": [
          "dyld_insert_libraries"
        ],
        "verified_boot_state": "verified_boot_state",
        "magisk_mount_present": true,
        "su_on_path": true
      },
      "hooks": {
        "detected": true,
        "frida_ports": [
          1.5
        ],
        "frida_thread_names": [
          "Acme Workspace"
        ],
        "hooked_symbols": [
          "hooked_symbols"
        ],
        "self_hooked_symbols": [
          "self_hooked_symbols"
        ],
        "prologue_anomaly_count": 3,
        "unexpected_dyld_images": [
          "string"
        ],
        "xposed_packages": [
          "xposed_packages"
        ]
      },
      "debugger": {
        "attached": true,
        "tracer_pid": 1.5,
        "breakpoint_count": 3,
        "watchpoint_thread_count": 3
      },
      "code_signing": {
        "invalid": true,
        "code_sign_valid": true,
        "text_integrity_ok": true,
        "application_debuggable": true,
        "dyld_insert_libraries": [
          "dyld_insert_libraries"
        ]
      },
      "simulator_or_emulator": {
        "detected": true,
        "is_ios_app_on_mac": true,
        "qemu_files": [
          "qemu_files"
        ],
        "ro_hardware": "ro_hardware",
        "ro_product_model": "chrome",
        "simulator_env_keys": [
          "FOIL_SAMPLE_KEY"
        ]
      },
      "hardware_claims_mismatch": {
        "detected": true,
        "signals": [
          "webdriver_detected"
        ]
      },
      "sim_posture": {
        "detected": true,
        "signals": [
          "webdriver_detected"
        ]
      },
      "app_provenance": {
        "detected": true,
        "signals": [
          "webdriver_detected"
        ]
      },
      "debug_posture": {
        "detected": true,
        "adb_enabled": true,
        "developer_options_enabled": true,
        "app_debuggable": true,
        "app_profileable": true,
        "app_test_only": true,
        "debugger_attached": true,
        "get_task_allow": true,
        "embedded_provisioning_profile_present": true,
        "receipt_is_sandbox": true,
        "receipt_is_testflight": true,
        "development_bundle": true,
        "active_debugger_attached": true,
        "breakpoint_count": 3,
        "exception_port_count": 3,
        "watchpoint_thread_count": 3,
        "tracer_pid": 1.5,
        "direct_syscall_tracer_pid": 1.5,
        "risk_signals": [
          "vpn"
        ]
      }
    },
    "native_app": {
      "bundle_id": "bundle_id",
      "app_version": "123.0.0.0",
      "app_build": "app_build",
      "install_time_epoch_ms": 1.5,
      "provisioning_team": "provisioning_team"
    },
    "native_carrier": {
      "platform": "ios",
      "carrier_name": "Acme Workspace",
      "country_iso": "United States",
      "mcc": "mcc",
      "mnc": "mnc",
      "phone_type": "phone_type",
      "network_type": "network_type",
      "radio_access": [
        "radio_access"
      ]
    },
    "native_motion_print": {
      "platform": "ios",
      "sample_count": 3,
      "gyro": {
        "bias": [
          1.5,
          2.5,
          3.5
        ],
        "noise": [
          1.5,
          2.5,
          3.5
        ]
      },
      "accel": {
        "bias": [
          1.5,
          2.5,
          3.5
        ],
        "noise": [
          1.5,
          2.5,
          3.5
        ]
      },
      "mag": {
        "bias": [
          1.5,
          2.5,
          3.5
        ],
        "noise": [
          1.5,
          2.5,
          3.5
        ]
      }
    },
    "device_identity": {
      "object": "device_identity",
      "id": "sid_87wfetm98myh9awj0dpt28a3kc",
      "confidence": 93,
      "source": "attested",
      "platform": "ios",
      "identified_at": "2026-03-24T20:00:05.000Z",
      "lifecycle": {
        "first_seen_at": "2026-03-01T18:22:11.000Z",
        "last_seen_at": "2026-03-24T20:00:05.000Z",
        "seen_count": 14
      },
      "matched_anchors": [
        "matched_anchors"
      ]
    },
    "install_id": "install_id",
    "visitor_fingerprint": {
      "object": "visitor_fingerprint",
      "id": "vid_7cyvmdfjs3rzznf8m65v3bv51m",
      "confidence": 1,
      "identified_at": "2026-03-24T20:00:05.000Z",
      "resolution": {
        "method": "continuity",
        "basis": "deterministic"
      },
      "lifecycle": {
        "first_seen_at": "2026-03-01T18:22:11.000Z",
        "last_seen_at": "2026-03-24T20:00:05.000Z",
        "seen_count": 1
      }
    },
    "connection_fingerprint": {
      "ja4": {
        "hash": "t13d1516h2_0123456789ab_fedcba987654",
        "profile": "chrome",
        "family": "chromium",
        "product": "chrome",
        "confidence": "exact",
        "match_source": "full_ja4",
        "deterministic": true,
        "reference": {
          "label": "Chrome",
          "source": "master_db",
          "protocol": "t",
          "tls_version": "13",
          "sni": "d",
          "alpn": "h2",
          "cipher_count": {
            "min": 15,
            "max": 16
          },
          "ext_count": {
            "min": 15,
            "max": 16
          },
          "sample_size": 63,
          "verified": true
        }
      },
      "http2": {
        "akamai_fingerprint": "1:65536;4:131072;5:16384|12517377|0|m,p,a,s",
        "profile": "chrome"
      },
      "user_agent_alignment": "match"
    },
    "previous_decisions": [
      {
        "event_id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
        "automation_status": "automated",
        "risk_score": 94,
        "evaluation_phase": "snapshot",
        "decision_status": "preliminary",
        "evaluated_at": "2026-03-24T20:00:05.000Z"
      }
    ],
    "request": {
      "url": "https://app.acme.co/signup",
      "referrer": "https://app.acme.co/",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36"
    },
    "browser": {
      "name": "Chromium",
      "version": "123.0.0.0",
      "major_version": "123",
      "engine": "blink",
      "app_name": null
    },
    "device": {
      "form_factor": "desktop",
      "operating_system": {
        "name": "macOS",
        "version": "123.0.0.0"
      },
      "architecture": "arm",
      "screen": {
        "size": "1440x900",
        "color_depth": 1,
        "pixel_ratio": 1.5,
        "orientation_type": "landscape-primary"
      },
      "locale": {
        "timezone": "America/Los_Angeles",
        "primary_language": "en-US",
        "languages": [
          "en-US",
          "en"
        ]
      },
      "capabilities": {
        "touch": {
          "available": true,
          "max_touch_points": 1
        },
        "storage": {
          "cookies": true,
          "local_storage": true,
          "indexed_db": true,
          "service_worker": true,
          "window_name": true
        },
        "webgpu": {
          "available": true
        },
        "platform_authenticator": {
          "available": true,
          "conditional_mediation": true
        },
        "media_devices": {
          "available": true
        },
        "speech_synthesis": {
          "available": true
        }
      }
    },
    "analysis_coverage": {
      "browser": true,
      "device": true,
      "network": true,
      "runtime": true,
      "behavioral": true,
      "visitor_identity": true
    },
    "signals_fired": [
      {
        "signal": "webdriver_detected",
        "role": "owner",
        "category": "environment",
        "strength": "definitive",
        "signal_score": 100
      }
    ],
    "client_telemetry": {
      "navigator": {
        "model": null,
        "platform": "macOS",
        "vendor": "Google Inc.",
        "hardware_concurrency": 8,
        "device_memory": 8,
        "max_touch_points": 0,
        "pdf_viewer_enabled": true,
        "cookie_enabled": true,
        "product_sub": "20030107",
        "primary_language": "en-US",
        "languages": [
          "en-US",
          "en"
        ],
        "mime_types_count": 3,
        "plugins": [
          "PDF Viewer"
        ]
      },
      "storage": {
        "cookies": true,
        "local_storage": true,
        "session_storage": true,
        "indexed_db": true,
        "service_worker": true,
        "window_name": true
      },
      "canvas": {
        "hash": 1234567890,
        "geometry_hash": 1234567890,
        "text_hash": 1234567890,
        "winding": true,
        "noise_detected": true,
        "offscreen_consistent": true
      },
      "graphics": {
        "webgl": {
          "vendor": "Google Inc.",
          "renderer": "ANGLE (Apple, ANGLE Metal Renderer: Apple M2, Unspecified Version)",
          "version": "WebGL 1.0",
          "shading_language_version": "WebGL GLSL ES 1.0",
          "parameters_hash": "01234567",
          "extensions_hash": 1234567890,
          "extension_parameters_hash": "01234567",
          "shader_precision_hash": 1234567890
        },
        "webgpu": {
          "available": true,
          "adapter_vendor": "Google Inc.",
          "adapter_architecture": "arm",
          "fallback_adapter": true,
          "features_hash": 1234567890,
          "limits_hash": 1234567890
        }
      },
      "audio": {
        "hash": 1.23456e-7,
        "sample_rate": 1.5,
        "channel_count": 3,
        "voice_count": 22,
        "local_voice_count": 20,
        "default_voice_lang": "en-US",
        "noise_detected": true
      },
      "fonts": {
        "detected_count": 3,
        "tested_count": 3,
        "enumeration_hash": 1234567890,
        "metrics_hash": 1234567890,
        "preferences_hash": 1234567890,
        "emoji_hash": 1234567890
      },
      "media": {
        "device_count": 3,
        "counts_by_kind": {
          "audioinput": 1,
          "audiooutput": 1,
          "videoinput": 1
        },
        "blank_label_count": 3,
        "topology_hash": 1234567890
      }
    },
    "attribution": {
      "labels": [
        {
          "kind": "actor",
          "value": "automation",
          "label": "Automation",
          "confidence": 98
        },
        {
          "kind": "tool",
          "value": "selenium",
          "label": "Selenium",
          "confidence": 88
        }
      ],
      "behaviors": [
        {
          "channel": "typing",
          "value": "synthetic-typing",
          "label": "Synthetic Typing",
          "confidence": 86
        }
      ]
    },
    "behavior": null
  },
  "meta": {
    "request_id": "req_cf147349a4134208aebb8c70e25fb7e1"
  }
}

{
  "error": {
    "code": "request.validation_failed",
    "message": "Observation payload failed validation.",
    "status": 1,
    "retryable": true,
    "request_id": "req_cf147349a4134208aebb8c70e25fb7e1",
    "docs_url": "https://app.acme.co/signup",
    "details": {
      "fields": [
        {
          "name": "Acme Growth Workspace",
          "issue": "required",
          "expected": "string",
          "received": "any_of"
        }
      ],
      "allowed_values": [
        "verified"
      ],
      "header_name": "x-forwarded-for",
      "parameter_set": "browser_fingerprint",
      "next_action": "retry"
    }
  }
}

{
  "error": {
    "code": "request.validation_failed",
    "message": "Observation payload failed validation.",
    "status": 1,
    "retryable": true,
    "request_id": "req_cf147349a4134208aebb8c70e25fb7e1",
    "docs_url": "https://app.acme.co/signup",
    "details": {
      "fields": [
        {
          "name": "Acme Growth Workspace",
          "issue": "required",
          "expected": "string",
          "received": "any_of"
        }
      ],
      "allowed_values": [
        "verified"
      ],
      "header_name": "x-forwarded-for",
      "parameter_set": "browser_fingerprint",
      "next_action": "retry"
    }
  }
}

{
  "error": {
    "code": "request.validation_failed",
    "message": "Observation payload failed validation.",
    "status": 1,
    "retryable": true,
    "request_id": "req_cf147349a4134208aebb8c70e25fb7e1",
    "docs_url": "https://app.acme.co/signup",
    "details": {
      "fields": [
        {
          "name": "Acme Growth Workspace",
          "issue": "required",
          "expected": "string",
          "received": "any_of"
        }
      ],
      "allowed_values": [
        "verified"
      ],
      "header_name": "x-forwarded-for",
      "parameter_set": "browser_fingerprint",
      "next_action": "retry"
    }
  }
}

{
  "error": {
    "code": "request.validation_failed",
    "message": "Observation payload failed validation.",
    "status": 1,
    "retryable": true,
    "request_id": "req_cf147349a4134208aebb8c70e25fb7e1",
    "docs_url": "https://app.acme.co/signup",
    "details": {
      "fields": [
        {
          "name": "Acme Growth Workspace",
          "issue": "required",
          "expected": "string",
          "received": "any_of"
        }
      ],
      "allowed_values": [
        "verified"
      ],
      "header_name": "x-forwarded-for",
      "parameter_set": "browser_fingerprint",
      "next_action": "retry"
    }
  }
}