openapi: 3.0.3
info:
  title: Weave Net HTTP DNS Network API
  description: The Weave Net HTTP API provides programmatic control over the Weave Net container networking daemon. It is exposed locally on port 6784 and allows management of IPAM (IP address allocation), peer connections, DNS registration, network exposure, and status monitoring. This API is used internally by the weave CLI and can be used by tooling that manages container network configuration.
  version: 2.0.0
  contact:
    url: https://github.com/weaveworks/weave
  license:
    name: Apache 2.0
    url: https://github.com/weaveworks/weave/blob/master/LICENSE
  x-generated-from: documentation
  x-last-validated: '2026-05-03'
servers:
- url: http://127.0.0.1:6784
  description: Local Weave Net daemon
tags:
- name: Network
paths:
  /expose/{cidr}:
    post:
      operationId: exposeNetwork
      summary: Weave Net Expose Network
      description: Assigns the given IP address/CIDR to the Weave bridge, exposing the Weave network to the host. This allows the host to communicate with containers on the Weave network.
      tags:
      - Network
      parameters:
      - name: cidr
        in: path
        required: true
        description: IP address and subnet in CIDR notation (e.g., 10.32.0.1/12)
        schema:
          type: string
        example: 10.32.0.1/12
      responses:
        '200':
          description: Network exposed successfully
        '400':
          description: Invalid CIDR address
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK