# Models

## The Error object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}
```

## The FingerprintEnvelope object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"FingerprintEnvelope":{"type":"object","properties":{"fingerprint":{"$ref":"#/components/schemas/Fingerprint"}},"required":["fingerprint"]},"Fingerprint":{"type":"object","description":"Native FingerprintConfig. Documented sub-objects are the common\nones; the object is open and stored verbatim by the create\nendpoints, so any field present here is round-tripped.\n","additionalProperties":true,"properties":{"name":{"type":"string"},"notes":{"type":"string"},"seed":{"type":"integer","description":"0 = overrides-only mode (the common case)."},"navigator":{"type":"object","additionalProperties":true,"properties":{"user_agent":{"type":"string"},"platform":{"type":"string"},"hardware_concurrency":{"type":"integer"},"device_memory":{"type":"integer","enum":[8,16,32]},"language":{"type":"string"},"do_not_track":{"type":"boolean"}}},"screen":{"type":"object","additionalProperties":true,"properties":{"width":{"type":"integer"},"height":{"type":"integer"},"avail_width":{"type":"integer"},"avail_height":{"type":"integer"},"color_depth":{"type":"integer"},"device_pixel_ratio":{"type":"number"},"color_gamut":{"type":"string","enum":["","srgb","p3","rec2020"]}}},"client_hints":{"type":"object","description":"Sec-CH-UA family (browser.vision calls this `hints`).","additionalProperties":true,"properties":{"platform":{"type":"string"},"platform_version":{"type":"string"},"architecture":{"type":"string"},"bitness":{"type":"string"},"mobile":{"type":"boolean"}}},"webgl":{"type":"object","additionalProperties":true,"properties":{"unmasked_vendor":{"type":"string"},"unmasked_renderer":{"type":"string"}}},"webgpu":{"type":"object","additionalProperties":true},"webrtc":{"type":"string","description":"WebRTC handling mode.","enum":["auto","tcp_only","block"]},"noise":{"$ref":"#/components/schemas/NoisePrefs"},"network":{"type":"object","properties":{"blocked_ports":{"type":"array","items":{"type":"integer"},"description":"Local-network port-scan defense (ports_protection)."}}},"timezone":{"type":"string","description":"IANA name, or \"auto\" to resolve from the bound proxy at launch."}}},"NoisePrefs":{"type":"object","description":"Per-vector anti-fingerprint noise. Each block is `{enabled, seed}`\n(+ feature-specific knobs). `enabled:false` = pass-through.\n","properties":{"canvas":{"$ref":"#/components/schemas/NoiseBlock"},"webgl":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"intensity":{"type":"number"}}},"audio":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"intensity":{"type":"number"}}},"client_rects":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"max_offset":{"type":"number"}}},"sensors":{"$ref":"#/components/schemas/NoiseBlock"},"fonts":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"description":"`enabled:true` hides a small deterministic per-profile subset of\nnon-essential fonts (real host fonts otherwise pass through).\n"}}},"NoiseBlock":{"type":"object","properties":{"enabled":{"type":"boolean"},"seed":{"type":"integer","description":"Per-profile entropy; 0 = derive automatically."}}}}}}
```

## The Fingerprint object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"Fingerprint":{"type":"object","description":"Native FingerprintConfig. Documented sub-objects are the common\nones; the object is open and stored verbatim by the create\nendpoints, so any field present here is round-tripped.\n","additionalProperties":true,"properties":{"name":{"type":"string"},"notes":{"type":"string"},"seed":{"type":"integer","description":"0 = overrides-only mode (the common case)."},"navigator":{"type":"object","additionalProperties":true,"properties":{"user_agent":{"type":"string"},"platform":{"type":"string"},"hardware_concurrency":{"type":"integer"},"device_memory":{"type":"integer","enum":[8,16,32]},"language":{"type":"string"},"do_not_track":{"type":"boolean"}}},"screen":{"type":"object","additionalProperties":true,"properties":{"width":{"type":"integer"},"height":{"type":"integer"},"avail_width":{"type":"integer"},"avail_height":{"type":"integer"},"color_depth":{"type":"integer"},"device_pixel_ratio":{"type":"number"},"color_gamut":{"type":"string","enum":["","srgb","p3","rec2020"]}}},"client_hints":{"type":"object","description":"Sec-CH-UA family (browser.vision calls this `hints`).","additionalProperties":true,"properties":{"platform":{"type":"string"},"platform_version":{"type":"string"},"architecture":{"type":"string"},"bitness":{"type":"string"},"mobile":{"type":"boolean"}}},"webgl":{"type":"object","additionalProperties":true,"properties":{"unmasked_vendor":{"type":"string"},"unmasked_renderer":{"type":"string"}}},"webgpu":{"type":"object","additionalProperties":true},"webrtc":{"type":"string","description":"WebRTC handling mode.","enum":["auto","tcp_only","block"]},"noise":{"$ref":"#/components/schemas/NoisePrefs"},"network":{"type":"object","properties":{"blocked_ports":{"type":"array","items":{"type":"integer"},"description":"Local-network port-scan defense (ports_protection)."}}},"timezone":{"type":"string","description":"IANA name, or \"auto\" to resolve from the bound proxy at launch."}}},"NoisePrefs":{"type":"object","description":"Per-vector anti-fingerprint noise. Each block is `{enabled, seed}`\n(+ feature-specific knobs). `enabled:false` = pass-through.\n","properties":{"canvas":{"$ref":"#/components/schemas/NoiseBlock"},"webgl":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"intensity":{"type":"number"}}},"audio":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"intensity":{"type":"number"}}},"client_rects":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"max_offset":{"type":"number"}}},"sensors":{"$ref":"#/components/schemas/NoiseBlock"},"fonts":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"description":"`enabled:true` hides a small deterministic per-profile subset of\nnon-essential fonts (real host fonts otherwise pass through).\n"}}},"NoiseBlock":{"type":"object","properties":{"enabled":{"type":"boolean"},"seed":{"type":"integer","description":"Per-profile entropy; 0 = derive automatically."}}}}}}
```

## The NoisePrefs object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"NoisePrefs":{"type":"object","description":"Per-vector anti-fingerprint noise. Each block is `{enabled, seed}`\n(+ feature-specific knobs). `enabled:false` = pass-through.\n","properties":{"canvas":{"$ref":"#/components/schemas/NoiseBlock"},"webgl":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"intensity":{"type":"number"}}},"audio":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"intensity":{"type":"number"}}},"client_rects":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"max_offset":{"type":"number"}}},"sensors":{"$ref":"#/components/schemas/NoiseBlock"},"fonts":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"description":"`enabled:true` hides a small deterministic per-profile subset of\nnon-essential fonts (real host fonts otherwise pass through).\n"}}},"NoiseBlock":{"type":"object","properties":{"enabled":{"type":"boolean"},"seed":{"type":"integer","description":"Per-profile entropy; 0 = derive automatically."}}}}}}
```

## The NoiseBlock object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"NoiseBlock":{"type":"object","properties":{"enabled":{"type":"boolean"},"seed":{"type":"integer","description":"Per-profile entropy; 0 = derive automatically."}}}}}}
```

## The CreateProfileRequest object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"CreateProfileRequest":{"type":"object","required":["fingerprint"],"properties":{"name":{"type":"string"},"notes":{"type":"string"},"proxy_id":{"type":"string","description":"Bind a proxy already in the store (by id)."},"proxy":{"type":"string","description":"Attach a proxy by string (`host:port:user:pass` or\n`scheme://user:pass@host:port`). On a **persistent** profile it is\nadded to the proxy store (deduped by endpoint) and full-tested\n(UDP + geo), then bound by id — so it appears in the proxy list\nand QUIC/WebRTC gating has a cached result. On a **temporary**\nprofile it is attached inline (not stored). Ignored if `proxy_id`\nis set.\n"},"folder":{"type":"string","description":"Folder tag (ignored on /folders/{folder}/profiles, which wins)."},"fingerprint":{"allOf":[{"$ref":"#/components/schemas/Fingerprint"}],"description":"Stored verbatim. Get one from /fingerprint/new and edit as needed."}}},"Fingerprint":{"type":"object","description":"Native FingerprintConfig. Documented sub-objects are the common\nones; the object is open and stored verbatim by the create\nendpoints, so any field present here is round-tripped.\n","additionalProperties":true,"properties":{"name":{"type":"string"},"notes":{"type":"string"},"seed":{"type":"integer","description":"0 = overrides-only mode (the common case)."},"navigator":{"type":"object","additionalProperties":true,"properties":{"user_agent":{"type":"string"},"platform":{"type":"string"},"hardware_concurrency":{"type":"integer"},"device_memory":{"type":"integer","enum":[8,16,32]},"language":{"type":"string"},"do_not_track":{"type":"boolean"}}},"screen":{"type":"object","additionalProperties":true,"properties":{"width":{"type":"integer"},"height":{"type":"integer"},"avail_width":{"type":"integer"},"avail_height":{"type":"integer"},"color_depth":{"type":"integer"},"device_pixel_ratio":{"type":"number"},"color_gamut":{"type":"string","enum":["","srgb","p3","rec2020"]}}},"client_hints":{"type":"object","description":"Sec-CH-UA family (browser.vision calls this `hints`).","additionalProperties":true,"properties":{"platform":{"type":"string"},"platform_version":{"type":"string"},"architecture":{"type":"string"},"bitness":{"type":"string"},"mobile":{"type":"boolean"}}},"webgl":{"type":"object","additionalProperties":true,"properties":{"unmasked_vendor":{"type":"string"},"unmasked_renderer":{"type":"string"}}},"webgpu":{"type":"object","additionalProperties":true},"webrtc":{"type":"string","description":"WebRTC handling mode.","enum":["auto","tcp_only","block"]},"noise":{"$ref":"#/components/schemas/NoisePrefs"},"network":{"type":"object","properties":{"blocked_ports":{"type":"array","items":{"type":"integer"},"description":"Local-network port-scan defense (ports_protection)."}}},"timezone":{"type":"string","description":"IANA name, or \"auto\" to resolve from the bound proxy at launch."}}},"NoisePrefs":{"type":"object","description":"Per-vector anti-fingerprint noise. Each block is `{enabled, seed}`\n(+ feature-specific knobs). `enabled:false` = pass-through.\n","properties":{"canvas":{"$ref":"#/components/schemas/NoiseBlock"},"webgl":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"intensity":{"type":"number"}}},"audio":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"intensity":{"type":"number"}}},"client_rects":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"max_offset":{"type":"number"}}},"sensors":{"$ref":"#/components/schemas/NoiseBlock"},"fonts":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"description":"`enabled:true` hides a small deterministic per-profile subset of\nnon-essential fonts (real host fonts otherwise pass through).\n"}}},"NoiseBlock":{"type":"object","properties":{"enabled":{"type":"boolean"},"seed":{"type":"integer","description":"Per-profile entropy; 0 = derive automatically."}}}}}}
```

## The EditProfileRequest object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"EditProfileRequest":{"type":"object","description":"All fields optional — only what's present is changed.","properties":{"name":{"type":"string"},"notes":{"type":"string"},"folder":{"type":"string","description":"\"\" unfiles (moves to All)."},"proxy_id":{"type":"string","description":"\"\" unbinds the proxy."},"proxy":{"type":"string","description":"Proxy string — stored (deduped) + full-tested, then bound."},"fingerprint":{"allOf":[{"$ref":"#/components/schemas/Fingerprint"}],"description":"When present, REPLACES the stored fingerprint verbatim."}}},"Fingerprint":{"type":"object","description":"Native FingerprintConfig. Documented sub-objects are the common\nones; the object is open and stored verbatim by the create\nendpoints, so any field present here is round-tripped.\n","additionalProperties":true,"properties":{"name":{"type":"string"},"notes":{"type":"string"},"seed":{"type":"integer","description":"0 = overrides-only mode (the common case)."},"navigator":{"type":"object","additionalProperties":true,"properties":{"user_agent":{"type":"string"},"platform":{"type":"string"},"hardware_concurrency":{"type":"integer"},"device_memory":{"type":"integer","enum":[8,16,32]},"language":{"type":"string"},"do_not_track":{"type":"boolean"}}},"screen":{"type":"object","additionalProperties":true,"properties":{"width":{"type":"integer"},"height":{"type":"integer"},"avail_width":{"type":"integer"},"avail_height":{"type":"integer"},"color_depth":{"type":"integer"},"device_pixel_ratio":{"type":"number"},"color_gamut":{"type":"string","enum":["","srgb","p3","rec2020"]}}},"client_hints":{"type":"object","description":"Sec-CH-UA family (browser.vision calls this `hints`).","additionalProperties":true,"properties":{"platform":{"type":"string"},"platform_version":{"type":"string"},"architecture":{"type":"string"},"bitness":{"type":"string"},"mobile":{"type":"boolean"}}},"webgl":{"type":"object","additionalProperties":true,"properties":{"unmasked_vendor":{"type":"string"},"unmasked_renderer":{"type":"string"}}},"webgpu":{"type":"object","additionalProperties":true},"webrtc":{"type":"string","description":"WebRTC handling mode.","enum":["auto","tcp_only","block"]},"noise":{"$ref":"#/components/schemas/NoisePrefs"},"network":{"type":"object","properties":{"blocked_ports":{"type":"array","items":{"type":"integer"},"description":"Local-network port-scan defense (ports_protection)."}}},"timezone":{"type":"string","description":"IANA name, or \"auto\" to resolve from the bound proxy at launch."}}},"NoisePrefs":{"type":"object","description":"Per-vector anti-fingerprint noise. Each block is `{enabled, seed}`\n(+ feature-specific knobs). `enabled:false` = pass-through.\n","properties":{"canvas":{"$ref":"#/components/schemas/NoiseBlock"},"webgl":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"intensity":{"type":"number"}}},"audio":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"intensity":{"type":"number"}}},"client_rects":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"properties":{"max_offset":{"type":"number"}}},"sensors":{"$ref":"#/components/schemas/NoiseBlock"},"fonts":{"allOf":[{"$ref":"#/components/schemas/NoiseBlock"}],"description":"`enabled:true` hides a small deterministic per-profile subset of\nnon-essential fonts (real host fonts otherwise pass through).\n"}}},"NoiseBlock":{"type":"object","properties":{"enabled":{"type":"boolean"},"seed":{"type":"integer","description":"Per-profile entropy; 0 = derive automatically."}}}}}}
```

## The TempProfileRequest object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"TempProfileRequest":{"type":"object","properties":{"fingerprint_id":{"type":"string","description":"Library entry to base off; random match for `platform` when omitted."},"platform":{"type":"string","enum":["Windows","macOS","Linux"],"description":"Used to pick a random fingerprint when `fingerprint_id` is omitted; host OS when both omitted."},"proxy":{"type":"string","description":"Inline proxy string (not saved to the store)."},"name":{"type":"string"},"folder":{"type":"string"}}}}}}
```

## The ProfileMeta object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"ProfileMeta":{"type":"object","description":"Launcher-facing profile metadata (returned by create).","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"notes":{"type":"string"},"proxy_id":{"type":"string","nullable":true},"last_launched_at":{"type":"string","nullable":true,"description":"ISO-8601 or null."},"created_at":{"type":"string","nullable":true},"pinned":{"type":"boolean"},"folder":{"type":"string"}}}}}}
```

## The ProfileListItem object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"ProfileListItem":{"allOf":[{"$ref":"#/components/schemas/ProfileMeta"},{"type":"object","properties":{"running":{"type":"boolean"},"pid":{"type":"integer","format":"int64","nullable":true},"cdp":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/CdpInfo"}]}}}]},"ProfileMeta":{"type":"object","description":"Launcher-facing profile metadata (returned by create).","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"notes":{"type":"string"},"proxy_id":{"type":"string","nullable":true},"last_launched_at":{"type":"string","nullable":true,"description":"ISO-8601 or null."},"created_at":{"type":"string","nullable":true},"pinned":{"type":"boolean"},"folder":{"type":"string"}}},"CdpInfo":{"type":"object","description":"Chrome DevTools Protocol endpoint of a running profile.","properties":{"port":{"type":"integer","description":"Chrome-chosen remote-debugging port."},"http_url":{"type":"string","description":"REST base (/json, /json/version)."},"web_socket_debugger_url":{"type":"string","description":"Browser-level WS endpoint for Puppeteer/Playwright `connect`."}}}}}}
```

## The StoredProfile object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"StoredProfile":{"type":"object","description":"Full on-disk profile: the `_meta` envelope plus the flattened\nFingerprintConfig (all `Fingerprint` fields appear at the top\nlevel). `running`/`cdp` are present only while the profile runs.\n","additionalProperties":true,"properties":{"_meta":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"proxy_id":{"type":"string","nullable":true},"inline_proxy":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/ProxyEntry"}]},"last_launched_at":{"type":"string","nullable":true},"created_at":{"type":"string","nullable":true},"pinned":{"type":"boolean"},"folder":{"type":"string"},"temporary":{"type":"boolean"}}},"running":{"type":"boolean"},"cdp":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/CdpInfo"}]}}},"ProxyEntry":{"type":"object","description":"Full proxy (as embedded in `_meta.inline_proxy`).","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["socks5","http","https"]},"host":{"type":"string"},"port":{"type":"integer"},"username":{"type":"string"},"password":{"type":"string"},"country":{"type":"string"},"notes":{"type":"string"}}},"CdpInfo":{"type":"object","description":"Chrome DevTools Protocol endpoint of a running profile.","properties":{"port":{"type":"integer","description":"Chrome-chosen remote-debugging port."},"http_url":{"type":"string","description":"REST base (/json, /json/version)."},"web_socket_debugger_url":{"type":"string","description":"Browser-level WS endpoint for Puppeteer/Playwright `connect`."}}}}}}
```

## The CdpInfo object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"CdpInfo":{"type":"object","description":"Chrome DevTools Protocol endpoint of a running profile.","properties":{"port":{"type":"integer","description":"Chrome-chosen remote-debugging port."},"http_url":{"type":"string","description":"REST base (/json, /json/version)."},"web_socket_debugger_url":{"type":"string","description":"Browser-level WS endpoint for Puppeteer/Playwright `connect`."}}}}}}
```

## The RunningProfile object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"RunningProfile":{"type":"object","properties":{"profile_id":{"type":"string"},"pid":{"type":"integer","format":"int64"},"cdp":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/CdpInfo"}]}}},"CdpInfo":{"type":"object","description":"Chrome DevTools Protocol endpoint of a running profile.","properties":{"port":{"type":"integer","description":"Chrome-chosen remote-debugging port."},"http_url":{"type":"string","description":"REST base (/json, /json/version)."},"web_socket_debugger_url":{"type":"string","description":"Browser-level WS endpoint for Puppeteer/Playwright `connect`."}}}}}}
```

## The LibraryEntry object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"LibraryEntry":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"platform":{"type":"string","enum":["Windows","macOS","Linux"]},"chrome":{"type":"string","description":"Chrome version string."},"gpu":{"type":"string"},"builtin":{"type":"boolean","description":"Part of the bundled starter set."}}}}}}
```

## The AddProxyRequest object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"AddProxyRequest":{"type":"object","description":"A proxy string OR explicit fields (string wins).","properties":{"proxy":{"type":"string","description":"`scheme://user:pass@host:port` or `host:port:user:pass`."},"kind":{"type":"string","enum":["socks5","http","https"]},"host":{"type":"string"},"port":{"type":"integer"},"username":{"type":"string"},"password":{"type":"string"},"name":{"type":"string"},"country":{"type":"string"},"notes":{"type":"string"}}}}}}
```

## The ProxySummary object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"ProxySummary":{"type":"object","description":"Stored proxy without credentials.","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["socks5","http","https"]},"host":{"type":"string"},"port":{"type":"integer"},"country":{"type":"string","description":"Informational tag (e.g. \"US\")."}}}}}}
```

## The Cookie object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"Cookie":{"type":"object","description":"A cookie in a tool-friendly shape (compatible with EditThisCookie /\nPuppeteer exports — `httpOnly`/`sameSite` are accepted as aliases on\nimport).\n","required":["domain","name","value"],"properties":{"domain":{"type":"string","description":"Cookie host (Chromium `host_key`), e.g. \".example.com\"."},"name":{"type":"string"},"value":{"type":"string"},"path":{"type":"string","default":"/"},"expires":{"type":"number","nullable":true,"description":"Unix seconds; null/absent = session cookie."},"secure":{"type":"boolean","default":false},"http_only":{"type":"boolean","default":false},"same_site":{"type":"string","enum":["Strict","Lax","None","unspecified"],"description":"Case-insensitive on import."}}}}}}
```

## The ProxyEntry object

```json
{"openapi":"3.0.3","info":{"title":"ShardX Launcher — Automation API","version":"0.1.0"},"components":{"schemas":{"ProxyEntry":{"type":"object","description":"Full proxy (as embedded in `_meta.inline_proxy`).","properties":{"id":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["socks5","http","https"]},"host":{"type":"string"},"port":{"type":"integer"},"username":{"type":"string"},"password":{"type":"string"},"country":{"type":"string"},"notes":{"type":"string"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.proxyshard.com/proxyshard/shardx-launcher-api/models.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.