Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

NetBird Services API

Interact with and view information about reverse proxy services.

NetBird Services API is one of 39 APIs that NetBird publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Services. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 10 operations across 6 paths, and defines 17 schemas. It is described by OpenAPI 3.1.0, at version 0.0.1.

Requests are made against a single base URL, https://api.netbird.io.

10 operations 6 paths 17 schemas 2 DELETE5 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.0.1
Base URL
https://api.netbird.io
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

NetBird Services API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). An API key is passed in the header as Authorization (TokenAuth). By default, every request must be authenticated.

  • TokenAuth — Enter the token with the Token prefix, e.g. "Token nbpF3f0d.....".

Paths & Operations 10

Across 6 paths, the API surfaces 10 operations — 2 DELETE, 5 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Services 10

Interact with and view information about reverse proxy services.

GET
/api/reverse-proxies/clusters
List available proxy clusters
→ 200401403500
GET
/api/reverse-proxies/services
List all Services
→ 200401403500
POST
/api/reverse-proxies/services
Create a Service
body → 200400401403409500
GET
/api/reverse-proxies/services/{serviceId}
Retrieve a Service
1 param → 200400401403404500
PUT
/api/reverse-proxies/services/{serviceId}
Update a Service
1 param body → 200400401403404409500
DELETE
/api/reverse-proxies/services/{serviceId}
Delete a Service
1 param → 200400401403404500
GET
/api/reverse-proxies/domains
Retrieve Service Domains
→ 200400401403404500
POST
/api/reverse-proxies/domains
Create a Custom domain
body → 200400401403404500
DELETE
/api/reverse-proxies/domains/{domainId}
Delete a Custom domain
1 param → 204400401403404500
GET
/api/reverse-proxies/domains/{domainId}/validate
Validate a custom domain
1 param → 202400401403404500

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are Service (15 properties), ServiceRequest (10 properties), ServiceTarget (8 properties), ReverseProxyDomain (8 properties). Each schema is shown below with its type and property counts.

HeaderAuthConfig
object
Static header-value authentication. The proxy checks that the named header matches the configured value.
3 properties 3 required
AccessRestrictions
object
Connection-level access restrictions based on IP address or geography. Applies to both HTTP and L4 services.
5 properties
PINAuthConfig
object
2 properties 2 required
Service
object
15 properties 7 required
ServiceTarget
object
8 properties 5 required
ReverseProxyDomain
object
8 properties 4 required
ServiceTargetOptions
object
6 properties
PasswordAuthConfig
object
2 properties 2 required
ServiceRequest
object
10 properties 3 required
ProxyCluster
object
A proxy cluster represents a group of proxy nodes serving the same address
2 properties 2 required
ServiceMeta
object
3 properties 2 required
ServiceAuthConfig
object
5 properties
ErrorResponse
object
Standard error response. Note: The exact structure of this error response is inferred from util.WriteErrorResponse and util.WriteError usage in the provided Go…
1 property
ReverseProxyDomainRequest
object
2 properties 2 required
LinkAuthConfig
object
1 property 1 required
ReverseProxyDomainType
string
Type of Reverse Proxy Domain
BearerAuthConfig
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

netbird-services-api-openapi.yml Raw ↑

Other APIs NetBird publishes across the network.

NetBird Accounts API
NetBird AWS Marketplace API
NetBird Checkout API
NetBird DNS API
NetBird DNS Zones API
NetBird EDR Falcon Integrations API
NetBird EDR FleetDM Integrations API
NetBird EDR Huntress Integrations API
NetBird EDR Intune Integrations API
NetBird EDR Peers API
NetBird EDR SentinelOne Integrations API
NetBird Event Streaming Integrations API