Update a subnet
Updates subnet properties. If the CIDR is being changed, validates that all existing ip_addresses on this subnet have IPs within the new CIDR range.
User API key (Bearer scp_u_...). Create in Platform > API Keys.
In: header
Path Parameters
Subnet ID
uuidRequest Body
application/json
Subnet in CIDR notation, IPv4 or IPv6.
^[0-9A-Fa-f.:]+/\d{1,3}$Human-facing name for this subnet.
The network this entity belongs to.
uuidWill be automatically set to Manual for creation through API
What kind of subnet this is — physical, virtual, container bridge, and so on.
"Internet" | "Remote" | "Gateway" | "VpnTunnel" | "Dmz" | "Lan" | "WiFi" | "IoT" | "Guest" | "DockerBridge" | "PodmanBridge" | "MacVlan" | "IpVlan" | "Management" | "Storage" | "Loopback" | "Unknown"Tags assigned to this entity.
The container runtime service that owns this bridge network.
Load-bearing for dedup: the same CIDR on two different Docker daemons is two distinct subnets, so bridge rows only merge when this matches as well as the CIDR and network. A foreign key rather than a field inside a JSONB blob because a stale value here is precisely what made a scan add a duplicate bridge row every time (GH #650) — now it cannot be written at all.
uuidFree-text notes about the subnet.
Response Body
application/json
application/json
application/json
curl -X PUT "https://app.scanopy.net/api/v1/subnets/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{ "cidr": "192.168.1.0/24", "created_at": "2026-01-15T10:30:00Z", "description": "Local area network", "first_discovery_id": null, "id": "550e8400-e29b-41d4-a716-446655440004", "last_discovery_id": null, "last_seen_at": "2026-01-15T10:30:00Z", "lineage_id": null, "name": "LAN", "network_id": "550e8400-e29b-41d4-a716-446655440002", "source": { "type": "Manual" }, "subnet_type": "Lan", "tags": [], "updated_at": "2026-01-15T10:30:00Z", "valid_from": "2026-01-15T10:30:00Z", "valid_to": null, "virtualization_service_id": null }'{
"meta": {
"api_version": 1,
"server_version": "0.17.8"
},
"success": true,
"data": {
"cidr": "192.168.1.0/24",
"created_at": "2026-01-15T10:30:00Z",
"description": "Local area network",
"first_discovery_id": null,
"id": "550e8400-e29b-41d4-a716-446655440004",
"last_discovery_id": null,
"last_seen_at": "2026-01-15T10:30:00Z",
"lineage_id": null,
"name": "LAN",
"network_id": "550e8400-e29b-41d4-a716-446655440002",
"source": {
"type": "Manual"
},
"subnet_type": "Lan",
"tags": [],
"updated_at": "2026-01-15T10:30:00Z",
"valid_from": "2026-01-15T10:30:00Z",
"valid_to": null,
"virtualization_service_id": null
},
"error": "string"
}{
"meta": {
"api_version": 1,
"server_version": "0.17.8"
},
"success": true,
"code": "string",
"error": "string",
"params": {
"property1": null,
"property2": null
}
}{
"meta": {
"api_version": 1,
"server_version": "0.17.8"
},
"success": true,
"code": "string",
"error": "string",
"params": {
"property1": null,
"property2": null
}
}