Get an instance's proxy
Returns the instance's own override (if any) and the proxy it effectively dials through, resolved as device override > tenant-wide > none.
Returns the instance's own override (if any) and the proxy it effectively dials through, resolved as device override > tenant-wide > none.
Authorization
bearerAuth Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.
In: header
Path Parameters
Instance (device) identifier.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/devices/ad14fdc2-b86a-42be-ba69-1107f0ac2244/proxy"{ "success": true, "device_id": "ad14fdc2-b86a-42be-ba69-1107f0ac2244", "override": { "proxy_url": "http://10.0.0.5:8080", "updated_at": "2026-06-16T12:05:00Z" }, "effective": { "proxy_url": "http://10.0.0.5:8080", "source": "device" }}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}Remove the tenant-wide proxy DELETE
Removes the tenant-wide proxy. The tenant's online instances are reconnected in the background so they fall back to a direct connection (or their own per-instance override, if any).
Get the tenant proxy configuration GET
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.