Firewalls

Create firewall

Creates a firewall to which firewall rules can be added. A firewall containing rules can be attached to one or more virtual machines to control inbound and outbound traffic. In the request body, include the firewall name, the ID of the environment it belongs to, and an optional description. Retrieve the ID of an environment by calling the list environments endpoint.

post/core/firewalls

Request

  • Base URL: https://infrahub-api.nexgencloud.com/v1
  • URL: https://infrahub-api.nexgencloud.com/v1/core/firewalls
  • Auth: API key in header api_key

Request body

environment_idinteger required

ID of the environment within which the firewall is created.

namestring required

Name of the firewall. Maximum length: 50 characters.

descriptionstring

Optional description of the firewall.

Response

Success

statusboolean

Whether the request succeeded.

messagestring

Human-readable description of the result.

Example response

{
  "status": true,
  "message": "Firewall is scheduled for creation.",
  "firewall": {
    "id": 7613,
    "name": "example-firewall",
    "description": "example",
    "environment": {
      "id": 2058,
      "name": "example-environment",
      "region": "NORWAY-1"
    },
    "status": "CREATING",
    "created_at": "2026-05-06T15:18:42Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.