Get the tenant proxy configuration
Returns the tenant-wide proxy (applied to every instance that has no override) together with every per-instance override. Passwords in proxy URLs are masked.
Returns the tenant-wide proxy (applied to every instance that has no override) together with every per-instance override. Passwords in proxy URLs are masked.
Authorization
bearerAuth Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.
In: header
Response Body
application/json
application/json
curl -X GET "https://example.com/proxy"{ "success": true, "tenant_proxy": { "proxy_url": "socks5://user:***@proxy.example.com:1080", "updated_at": "2026-06-16T12:00:00Z" }, "device_overrides": [ { "device_id": "ad14fdc2-b86a-42be-ba69-1107f0ac2244", "proxy_url": "http://10.0.0.5:8080", "updated_at": "2026-06-16T12:05:00Z" } ]}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}Get an instance's proxy GET
Returns the instance's own override (if any) and the proxy it effectively dials through, resolved as device override > tenant-wide > none.
Set an instance proxy override PUT
Sets a proxy for a single instance. The override wins over the tenant-wide proxy. The instance is reconnected so it dials through the new proxy immediately.