# Contabo Firewalls API

**Canonical:** https://apis.io/apis/contabo/contabo-firewalls-api/  
**Provider:** Contabo — https://apis.io/providers/contabo/  
**Base URL:** https://api.contabo.com  
**Documentation:** https://api.contabo.com/

Contabo Firewalls API is one of 39 APIs that [Contabo](https://apis.io/providers/contabo/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Firewalls. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Firewall API allows you to create and manage firewalls for your instances (Cloud VPS/VDS). Each instance protected by customizable inbound firewall rules requires a paid firewall add-on. Rules allow inbound traffic based on protocols (TCP, UDP, ICMP), ports and sources (IPs or nets).

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/firewalls` | Create a new firewall definition |
| GET | `/v1/firewalls` | List all firewalls |
| DELETE | `/v1/firewalls/{firewallId}` | Delete existing firewall by id |
| GET | `/v1/firewalls/{firewallId}` | Get specific firewall by its id |
| PATCH | `/v1/firewalls/{firewallId}` | Update a firewall by id |
| PUT | `/v1/firewalls/{firewallId}` | Update specific firewall rules |
| POST | `/v1/firewalls/{firewallId}/instances/{instanceId}` | Add instance to a firewall |
| DELETE | `/v1/firewalls/{firewallId}/instances/{instanceId}` | Remove instance from a firewall |
| GET | `/v1/firewalls/preset-rules` | Get all preset rules |

## Machine-readable artifacts (9)

- **OpenAPI** — https://artifacts.apis.io/contabo/openapi/contabo-firewalls-api-openapi.yml
- **Documentation** — https://api.contabo.com/
- **CLI** — https://github.com/contabo/cntb
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-create-instance-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-handle-create-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-handle-patch-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-create-user-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-reinstall-instance-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-update-user-request-schema.json

## Other Contabo APIs (12)

- [Contabo Check Collection Templates API](https://apis.io/apis/contabo/contabo-check-collection-templates-api/)
- [Contabo Check Collections API](https://apis.io/apis/contabo/contabo-check-collections-api/)
- [Contabo Checks API](https://apis.io/apis/contabo/contabo-checks-api/)
- [Contabo DNS API](https://apis.io/apis/contabo/contabo-dns-api/)
- [Contabo DNS Audits API](https://apis.io/apis/contabo/contabo-dns-audits-api/)
- [Contabo Domains API](https://apis.io/apis/contabo/contabo-domains-api/)
- [Contabo Domains Audits API](https://apis.io/apis/contabo/contabo-domains-audits-api/)
- [Contabo Firewalls Audits API](https://apis.io/apis/contabo/contabo-firewalls-audits-api/)
- [Contabo Handles API](https://apis.io/apis/contabo/contabo-handles-api/)
- [Contabo Handles Audits API](https://apis.io/apis/contabo/contabo-handles-audits-api/)
- [Contabo Images API](https://apis.io/apis/contabo/contabo-images-api/)
- [Contabo Images Audits API](https://apis.io/apis/contabo/contabo-images-audits-api/)

## Tags

Firewalls

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/contabo/contabo-firewalls-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/contabo/.