# Network

Host network interfaces.

Generated from Plakar Control Plane v0.18. See [OpenAPI v1](https://www.plakar.io/docs/control-plane/references/openapi/v1/index.md) for the base URL, authentication and error format.


## List the network interfaces

`GET /api/v1/network/interfaces`

Authentication: badge

Responses:

- `200` OK: `NetworkInterfacesResponse`
- `400` Bad Request _(validation or deserialization error)_: `HTTPError`
- `401` Missing, invalid or expired credentials
- `403` The caller may not do this: `HTTPError`
- `500` Internal Server Error _(panics)_: `HTTPError`
- `default`

## Configure a network interface

`POST /api/v1/network/interfaces`

Authentication: badge

Request body (application/json): `NetworkConfigureRequest`

Responses:

- `200` OK: `NetworkInterface`
- `400` Bad Request _(validation or deserialization error)_: `HTTPError`
- `401` Missing, invalid or expired credentials
- `403` The caller may not do this: `HTTPError`
- `500` Internal Server Error _(panics)_: `HTTPError`
- `default`