---
title: "Update a jail network"
method: PATCH
path: "/jail/{ctid}/networks/{networkId}"
tags: ["Jail"]
---

# Update a jail network

`PATCH /jail/{ctid}/networks/{networkId}`

Partially update a network attachment belonging to an inactive jail. Omitted fields are preserved.

## Path parameters

- `ctid` integer, required
- `networkId` integer, required

## Request body

- GithubComAlchemillahqSylveInternalInterfacesServicesJailEditJailNetworkRequest
  - `defaultGateway` boolean
  - `dhcp` boolean
  - `ip4` integer
  - `ip4Raw` string
  - `ip4gw` integer
  - `ip4gwRaw` string
  - `ip6` integer
  - `ip6Raw` string
  - `ip6gw` integer
  - `ip6gwRaw` string
  - `macId` integer
  - `macRaw` string
  - `name` string
  - `slaac` boolean
  - `switchName` string
  - `vlan` integer

## Response `200`

Success

- GithubComAlchemillahqSylveInternalAPIResponseGithubComAlchemillahqSylveInternalDbModelsJailNetwork
  - `data` GithubComAlchemillahqSylveInternalDbModelsJailNetwork
    - `defaultGateway` boolean
    - `dhcp` boolean
    - `id` integer
    - `ipv4GwId` integer
    - `ipv4GwObj` GithubComAlchemillahqSylveInternalDbModelsNetworkObject
      - `autoUpdate` boolean
      - `createdAt` string
      - `description` string
      - `entries` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectEntry[]
        - `createdAt` string
        - `id` integer
        - `objectId` integer
        - `updatedAt` string
        - `value` string — IP, CIDR, port, country code, FQDN, etc.
      - `id` integer
      - `isUsed` boolean
      - `isUsedBy` string — "", "dhcp" for now
      - `lastRefreshAt` string
      - `lastRefreshError` string
      - `name` string
      - `refreshIntervalSeconds` integer
      - `resolutionChecksum` string
      - `resolutions` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectResolution[]
        - `createdAt` string
        - `id` integer
        - `objectId` integer
        - `resolvedIp` string — deprecated mirror for resolved IP entries
        - `resolvedValue` string
        - `updatedAt` string
      - `sourceChecksum` string
      - `type` string — "Host", "Mac", "Network", "Port", "Country", "List", "FQDN", "DUID"
      - `updatedAt` string
    - `ipv4Id` integer
    - `ipv4Obj` GithubComAlchemillahqSylveInternalDbModelsNetworkObject
      - `autoUpdate` boolean
      - `createdAt` string
      - `description` string
      - `entries` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectEntry[]
        - `createdAt` string
        - `id` integer
        - `objectId` integer
        - `updatedAt` string
        - `value` string — IP, CIDR, port, country code, FQDN, etc.
      - `id` integer
      - `isUsed` boolean
      - `isUsedBy` string — "", "dhcp" for now
      - `lastRefreshAt` string
      - `lastRefreshError` string
      - `name` string
      - `refreshIntervalSeconds` integer
      - `resolutionChecksum` string
      - `resolutions` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectResolution[]
        - `createdAt` string
        - `id` integer
        - `objectId` integer
        - `resolvedIp` string — deprecated mirror for resolved IP entries
        - `resolvedValue` string
        - `updatedAt` string
      - `sourceChecksum` string
      - `type` string — "Host", "Mac", "Network", "Port", "Country", "List", "FQDN", "DUID"
      - `updatedAt` string
    - `ipv6GwId` integer
    - `ipv6GwObj` GithubComAlchemillahqSylveInternalDbModelsNetworkObject
      - `autoUpdate` boolean
      - `createdAt` string
      - `description` string
      - `entries` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectEntry[]
        - `createdAt` string
        - `id` integer
        - `objectId` integer
        - `updatedAt` string
        - `value` string — IP, CIDR, port, country code, FQDN, etc.
      - `id` integer
      - `isUsed` boolean
      - `isUsedBy` string — "", "dhcp" for now
      - `lastRefreshAt` string
      - `lastRefreshError` string
      - `name` string
      - `refreshIntervalSeconds` integer
      - `resolutionChecksum` string
      - `resolutions` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectResolution[]
        - `createdAt` string
        - `id` integer
        - `objectId` integer
        - `resolvedIp` string — deprecated mirror for resolved IP entries
        - `resolvedValue` string
        - `updatedAt` string
      - `sourceChecksum` string
      - `type` string — "Host", "Mac", "Network", "Port", "Country", "List", "FQDN", "DUID"
      - `updatedAt` string
    - `ipv6Id` integer
    - `ipv6Obj` GithubComAlchemillahqSylveInternalDbModelsNetworkObject
      - `autoUpdate` boolean
      - `createdAt` string
      - `description` string
      - `entries` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectEntry[]
        - `createdAt` string
        - `id` integer
        - `objectId` integer
        - `updatedAt` string
        - `value` string — IP, CIDR, port, country code, FQDN, etc.
      - `id` integer
      - `isUsed` boolean
      - `isUsedBy` string — "", "dhcp" for now
      - `lastRefreshAt` string
      - `lastRefreshError` string
      - `name` string
      - `refreshIntervalSeconds` integer
      - `resolutionChecksum` string
      - `resolutions` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectResolution[]
        - `createdAt` string
        - `id` integer
        - `objectId` integer
        - `resolvedIp` string — deprecated mirror for resolved IP entries
        - `resolvedValue` string
        - `updatedAt` string
      - `sourceChecksum` string
      - `type` string — "Host", "Mac", "Network", "Port", "Country", "List", "FQDN", "DUID"
      - `updatedAt` string
    - `jid` integer
    - `macId` integer
    - `macObj` GithubComAlchemillahqSylveInternalDbModelsNetworkObject
      - `autoUpdate` boolean
      - `createdAt` string
      - `description` string
      - `entries` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectEntry[]
        - `createdAt` string
        - `id` integer
        - `objectId` integer
        - `updatedAt` string
        - `value` string — IP, CIDR, port, country code, FQDN, etc.
      - `id` integer
      - `isUsed` boolean
      - `isUsedBy` string — "", "dhcp" for now
      - `lastRefreshAt` string
      - `lastRefreshError` string
      - `name` string
      - `refreshIntervalSeconds` integer
      - `resolutionChecksum` string
      - `resolutions` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectResolution[]
        - `createdAt` string
        - `id` integer
        - `objectId` integer
        - `resolvedIp` string — deprecated mirror for resolved IP entries
        - `resolvedValue` string
        - `updatedAt` string
      - `sourceChecksum` string
      - `type` string — "Host", "Mac", "Network", "Port", "Country", "List", "FQDN", "DUID"
      - `updatedAt` string
    - `manualSwitch` GithubComAlchemillahqSylveInternalDbModelsNetworkManualSwitch
      - `bridge` string
      - `createdAt` string
      - `id` integer
      - `name` string
      - `updatedAt` string
    - `name` string
    - `slaac` boolean
    - `standardSwitch` GithubComAlchemillahqSylveInternalDbModelsNetworkStandardSwitch
      - `address` string
      - `address6` string
      - `address6Id` integer
      - `address6Obj` GithubComAlchemillahqSylveInternalDbModelsNetworkObject
        - `autoUpdate` boolean
        - `createdAt` string
        - `description` string
        - `entries` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectEntry[]
          - `createdAt` string
          - `id` integer
          - `objectId` integer
          - `updatedAt` string
          - `value` string — IP, CIDR, port, country code, FQDN, etc.
        - `id` integer
        - `isUsed` boolean
        - `isUsedBy` string — "", "dhcp" for now
        - `lastRefreshAt` string
        - `lastRefreshError` string
        - `name` string
        - `refreshIntervalSeconds` integer
        - `resolutionChecksum` string
        - `resolutions` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectResolution[]
          - `createdAt` string
          - `id` integer
          - `objectId` integer
          - `resolvedIp` string — deprecated mirror for resolved IP entries
          - `resolvedValue` string
          - `updatedAt` string
        - `sourceChecksum` string
        - `type` string — "Host", "Mac", "Network", "Port", "Country", "List", "FQDN", "DUID"
        - `updatedAt` string
      - `addressId` integer
      - `addressObj` GithubComAlchemillahqSylveInternalDbModelsNetworkObject
        - `autoUpdate` boolean
        - `createdAt` string
        - `description` string
        - `entries` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectEntry[]
          - `createdAt` string
          - `id` integer
          - `objectId` integer
          - `updatedAt` string
          - `value` string — IP, CIDR, port, country code, FQDN, etc.
        - `id` integer
        - `isUsed` boolean
        - `isUsedBy` string — "", "dhcp" for now
        - `lastRefreshAt` string
        - `lastRefreshError` string
        - `name` string
        - `refreshIntervalSeconds` integer
        - `resolutionChecksum` string
        - `resolutions` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectResolution[]
          - `createdAt` string
          - `id` integer
          - `objectId` integer
          - `resolvedIp` string — deprecated mirror for resolved IP entries
          - `resolvedValue` string
          - `updatedAt` string
        - `sourceChecksum` string
        - `type` string — "Host", "Mac", "Network", "Port", "Country", "List", "FQDN", "DUID"
        - `updatedAt` string
      - `bridgeName` string
      - `createdAt` string
      - `defaultRoute` boolean
      - `dhcp` boolean
      - `disableBridgeOffloads` boolean — DisableBridgeOffloads keeps FreeBSD from changing bridge-member capabilities as transient tap and epair interfaces come and go. Sorts flapping issues (Please tell @hayzam if you faced flapping before/after enabling this option).
      - `disableIPv6` boolean
      - `gateway6AddressId` integer
      - `gateway6AddressObj` GithubComAlchemillahqSylveInternalDbModelsNetworkObject
        - `autoUpdate` boolean
        - `createdAt` string
        - `description` string
        - `entries` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectEntry[]
          - `createdAt` string
          - `id` integer
          - `objectId` integer
          - `updatedAt` string
          - `value` string — IP, CIDR, port, country code, FQDN, etc.
        - `id` integer
        - `isUsed` boolean
        - `isUsedBy` string — "", "dhcp" for now
        - `lastRefreshAt` string
        - `lastRefreshError` string
        - `name` string
        - `refreshIntervalSeconds` integer
        - `resolutionChecksum` string
        - `resolutions` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectResolution[]
          - `createdAt` string
          - `id` integer
          - `objectId` integer
          - `resolvedIp` string — deprecated mirror for resolved IP entries
          - `resolvedValue` string
          - `updatedAt` string
        - `sourceChecksum` string
        - `type` string — "Host", "Mac", "Network", "Port", "Country", "List", "FQDN", "DUID"
        - `updatedAt` string
      - `gateway6Manual` string
      - `gatewayAddressId` integer
      - `gatewayAddressObj` GithubComAlchemillahqSylveInternalDbModelsNetworkObject
        - `autoUpdate` boolean
        - `createdAt` string
        - `description` string
        - `entries` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectEntry[]
          - `createdAt` string
          - `id` integer
          - `objectId` integer
          - `updatedAt` string
          - `value` string — IP, CIDR, port, country code, FQDN, etc.
        - `id` integer
        - `isUsed` boolean
        - `isUsedBy` string — "", "dhcp" for now
        - `lastRefreshAt` string
        - `lastRefreshError` string
        - `name` string
        - `refreshIntervalSeconds` integer
        - `resolutionChecksum` string
        - `resolutions` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectResolution[]
          - `createdAt` string
          - `id` integer
          - `objectId` integer
          - `resolvedIp` string — deprecated mirror for resolved IP entries
          - `resolvedValue` string
          - `updatedAt` string
        - `sourceChecksum` string
        - `type` string — "Host", "Mac", "Network", "Port", "Country", "List", "FQDN", "DUID"
        - `updatedAt` string
      - `gatewayManual` string
      - `id` integer
      - `mtu` integer
      - `name` string
      - `network6Id` integer
      - `network6Manual` string
      - `network6Obj` GithubComAlchemillahqSylveInternalDbModelsNetworkObject
        - `autoUpdate` boolean
        - `createdAt` string
        - `description` string
        - `entries` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectEntry[]
          - `createdAt` string
          - `id` integer
          - `objectId` integer
          - `updatedAt` string
          - `value` string — IP, CIDR, port, country code, FQDN, etc.
        - `id` integer
        - `isUsed` boolean
        - `isUsedBy` string — "", "dhcp" for now
        - `lastRefreshAt` string
        - `lastRefreshError` string
        - `name` string
        - `refreshIntervalSeconds` integer
        - `resolutionChecksum` string
        - `resolutions` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectResolution[]
          - `createdAt` string
          - `id` integer
          - `objectId` integer
          - `resolvedIp` string — deprecated mirror for resolved IP entries
          - `resolvedValue` string
          - `updatedAt` string
        - `sourceChecksum` string
        - `type` string — "Host", "Mac", "Network", "Port", "Country", "List", "FQDN", "DUID"
        - `updatedAt` string
      - `networkId` integer
      - `networkManual` string
      - `networkObj` GithubComAlchemillahqSylveInternalDbModelsNetworkObject
        - `autoUpdate` boolean
        - `createdAt` string
        - `description` string
        - `entries` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectEntry[]
          - `createdAt` string
          - `id` integer
          - `objectId` integer
          - `updatedAt` string
          - `value` string — IP, CIDR, port, country code, FQDN, etc.
        - `id` integer
        - `isUsed` boolean
        - `isUsedBy` string — "", "dhcp" for now
        - `lastRefreshAt` string
        - `lastRefreshError` string
        - `name` string
        - `refreshIntervalSeconds` integer
        - `resolutionChecksum` string
        - `resolutions` GithubComAlchemillahqSylveInternalDbModelsNetworkObjectResolution[]
          - `createdAt` string
          - `id` integer
          - `objectId` integer
          - `resolvedIp` string — deprecated mirror for resolved IP entries
          - `resolvedValue` string
          - `updatedAt` string
        - `sourceChecksum` string
        - `type` string — "Host", "Mac", "Network", "Port", "Country", "List", "FQDN", "DUID"
        - `updatedAt` string
      - `ports` GithubComAlchemillahqSylveInternalDbModelsNetworkNetworkPort[]
        - `id` integer
        - `name` string
        - `switch` GithubComAlchemillahqSylveInternalDbModelsNetworkStandardSwitch — recursive
        - `switchId` integer
      - `private` boolean
      - `slaac` boolean
      - `updatedAt` string
      - `vlan` integer
    - `switchId` integer
    - `switchType` string
    - `vlan` integer
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `413` — Request Entity Too Large
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/alchemillahq/apis/sylve-api.md) · [All operations](https://skmtc.net/alchemillahq/apis/sylve-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alchemillahq/sylve-api/revisions/7a7bea85004e/schema)