Sign in
Subnets

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.

put/api/v1/subnets/{id}

Path parameters

idstring uuid required

Subnet ID

Request body

cidrstring required
descriptionstring nullable
namestring required
network_idstring uuid required
subnet_type'Internet' | 'Remote' | 'Gateway' | 'VpnTunnel' | 'Dmz' | 'Lan' | 'WiFi' | 'IoT' | 'Guest' | 'DockerBridge' | 'PodmanBridge' | 'MacVlan' | 'IpVlan' | 'Management' | 'Storage' | 'Loopback' | 'Unknown' required
tagsstring[] required
created_atstring date-time required
first_discovery_idstring uuid nullable
idstring uuid required
last_discovery_idstring uuid nullable
last_seen_atstring date-time
lineage_idstring uuid nullable
updated_atstring date-time required
valid_fromstring date-time
valid_tostring date-time nullable

Example request

{
  "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
}

Response

Subnet updated

errorstring nullable
successboolean required

Example response

{
  "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
  },
  "meta": {
    "api_version": 1,
    "server_version": "0.17.5"
  }
}

Changes