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 Users API

Interact with and view information about users.

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

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

This API exposes 15 operations across 12 paths, and defines 12 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.

15 operations 12 paths 12 schemas 3 DELETE4 GET6 POST2 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 Users 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 15

Across 12 paths, the API surfaces 15 operations — 3 DELETE, 4 GET, 6 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Users 15

Interact with and view information about users.

GET
/api/users
List all Users
1 param → 200400401403500
POST
/api/users
Create a User
body → 200400401403500
PUT
/api/users/{userId}
Update a User
1 param body → 200400401403500
DELETE
/api/users/{userId}
Delete a User
1 param → 200400401403500
POST
/api/users/{userId}/invite
Resend user invitation
1 param → 200400401403500
POST
/api/users/{userId}/approve
Approve user
1 param → 200400401403500
DELETE
/api/users/{userId}/reject
Reject user
1 param → 200400401403500
PUT
/api/users/{userId}/password
Change user password
1 param body → 200400401403412500
GET
/api/users/current
Retrieve current user
→ 200400401403500
GET
/api/users/invites
List user invites
→ 200401403412500
POST
/api/users/invites
Create a user invite
body → 200400401403409412422500
DELETE
/api/users/invites/{inviteId}
Delete a user invite
1 param → 200401403404412500
POST
/api/users/invites/{inviteId}/regenerate
Regenerate a user invite
1 param body → 200400401403404412422500
GET
/api/users/invites/{token}
Get invite information
1 param → 200400404500
POST
/api/users/invites/{token}/accept
Accept an invite
1 param body → 200400404412422500

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are User (15 properties), UserInvite (9 properties), UserCreateRequest (5 properties), UserInviteCreateRequest (5 properties). Each schema is shown below with its type and property counts.

UserInviteAcceptResponse
object
Response after accepting an invite
1 property 1 required
UserInviteInfo
object
Public information about an invite
5 properties 5 required
UserInviteRegenerateResponse
object
Response after regenerating an invite
2 properties 2 required
UserInviteAcceptRequest
object
Request to accept an invite and set password
1 property 1 required
UserInviteCreateRequest
object
Request to create a user invite link
5 properties 4 required
UserCreateRequest
object
5 properties 3 required
UserInvite
object
A user invite
9 properties 8 required
UserPermissions
object
2 properties 2 required
PasswordChangeRequest
object
2 properties 2 required
UserInviteRegenerateRequest
object
Request to regenerate an invite link
1 property
UserRequest
object
3 properties 3 required
User
object
15 properties 8 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

netbird-users-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