EnrollmentKeys

Lists all EnrollmentKeys for admins

get

Authorizations

oauth

Responses

200

OK

application/json

500

Internal Server Error

application/json

get

/api/v1/enrollment-keys

HTTPcURLJavaScriptPython

GET /api/v1/enrollment-keys HTTP/1.1
Host: api.demo.netmaker.io
Accept: */*

[
  {
    "default": true,
    "expiration": "text",
    "groups": [
      "text"
    ],
    "networks": [
      "text"
    ],
    "relay": "text",
    "tags": [
      "text"
    ],
    "token": "text",
    "type": 0,
    "unlimited": true,
    "uses_remaining": 1,
    "value": "text"
  }
]

Creates an EnrollmentKey for hosts to register with server and join networks

post

Authorizations

oauth

Body

application/json

expirationinteger · int64Optional

groupsstring[]Optional

networksstring[]Optional

relaystringOptional

tagsstring[]Required

typeinteger · enumOptionalPossible values:

unlimitedbooleanOptional

uses_remainingintegerOptional

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/api/v1/enrollment-keys

HTTPcURLJavaScriptPython

POST /api/v1/enrollment-keys HTTP/1.1
Host: api.demo.netmaker.io
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "expiration": 1,
  "groups": [
    "text"
  ],
  "networks": [
    "text"
  ],
  "relay": "text",
  "tags": [
    "text"
  ],
  "type": 0,
  "unlimited": true,
  "uses_remaining": 1
}

{
  "default": true,
  "expiration": "text",
  "groups": [
    "text"
  ],
  "networks": [
    "text"
  ],
  "relay": "text",
  "tags": [
    "text"
  ],
  "token": "text",
  "type": 0,
  "unlimited": true,
  "uses_remaining": 1,
  "value": "text"
}

Updates an EnrollmentKey. Updates are only limited to the relay to use

put

Authorizations

oauth

Path parameters

keyidstringRequired

Enrollment Key ID

Body

application/json

expirationinteger · int64Optional

groupsstring[]Optional

networksstring[]Optional

relaystringOptional

tagsstring[]Required

typeinteger · enumOptionalPossible values:

unlimitedbooleanOptional

uses_remainingintegerOptional

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

put

/api/v1/enrollment-keys/{keyid}

HTTPcURLJavaScriptPython

PUT /api/v1/enrollment-keys/{keyid} HTTP/1.1
Host: api.demo.netmaker.io
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "expiration": 1,
  "groups": [
    "text"
  ],
  "networks": [
    "text"
  ],
  "relay": "text",
  "tags": [
    "text"
  ],
  "type": 0,
  "unlimited": true,
  "uses_remaining": 1
}

{
  "default": true,
  "expiration": "text",
  "groups": [
    "text"
  ],
  "networks": [
    "text"
  ],
  "relay": "text",
  "tags": [
    "text"
  ],
  "token": "text",
  "type": 0,
  "unlimited": true,
  "uses_remaining": 1,
  "value": "text"
}

Deletes an EnrollmentKey from Netmaker server

delete

Authorizations

oauth

Path parameters

keyidstringRequired

Enrollment Key ID

Responses

200

OK

No content

500

Internal Server Error

application/json

delete

/api/v1/enrollment-keys/{keyid}

HTTPcURLJavaScriptPython

DELETE /api/v1/enrollment-keys/{keyid} HTTP/1.1
Host: api.demo.netmaker.io
Accept: */*

No content

Handles a Netclient registration with server and add nodes accordingly

post

Authorizations

oauth

Path parameters

tokenstringRequired

Enrollment Key Token

Body

application/json

autoupdatebooleanOptional

daemoninstalledbooleanOptional

debugbooleanOptional

defaultinterfacestringOptional

endpointipinteger[]Optional

endpointipv6integer[]Optional

firewallinusestringOptional

hostpassstringOptional

idstringOptional

interfacestringOptional

ipforwardingbooleanOptional

isdefaultbooleanOptional

isdockerbooleanOptional

isk8sbooleanOptional

isstaticbooleanOptional

isstaticportbooleanOptional

listenportintegerOptional

macaddressinteger[]Optional

mtuintegerOptional

namestringOptional

nat_typestringOptional

nodesstring[]Optional

osstringOptional

persistentkeepaliveinteger · int64Optional

publickeyinteger[]Optional

traffickeypublicinteger[]Optional

turn_endpointobjectOptional

verbosityintegerOptional

versionstringOptional

wg_public_listen_portintegerOptional

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/api/v1/host/register/{token}

HTTPcURLJavaScriptPython

POST /api/v1/host/register/{token} HTTP/1.1
Host: api.demo.netmaker.io
Content-Type: application/json
Accept: */*
Content-Length: 617

{
  "autoupdate": true,
  "daemoninstalled": true,
  "debug": true,
  "defaultinterface": "text",
  "endpointip": [
    1
  ],
  "endpointipv6": [
    1
  ],
  "firewallinuse": "text",
  "hostpass": "text",
  "id": "text",
  "interface": "text",
  "interfaces": [
    {
      "address": {
        "ip": [
          1
        ],
        "mask": [
          1
        ]
      },
      "addressString": "text",
      "name": "text"
    }
  ],
  "ipforwarding": true,
  "isdefault": true,
  "isdocker": true,
  "isk8s": true,
  "isstatic": true,
  "isstaticport": true,
  "listenport": 1,
  "macaddress": [
    1
  ],
  "mtu": 1,
  "name": "text",
  "nat_type": "text",
  "nodes": [
    "text"
  ],
  "os": "text",
  "persistentkeepalive": 1,
  "publickey": [
    1
  ],
  "traffickeypublic": [
    1
  ],
  "turn_endpoint": {},
  "verbosity": 1,
  "version": "text",
  "wg_public_listen_port": 1
}

{
  "requested_host": {
    "autoupdate": true,
    "daemoninstalled": true,
    "debug": true,
    "defaultinterface": "text",
    "endpointip": [
      1
    ],
    "endpointipv6": [
      1
    ],
    "firewallinuse": "text",
    "hostpass": "text",
    "id": "text",
    "interface": "text",
    "interfaces": [
      {
        "address": {
          "ip": [
            1
          ],
          "mask": [
            1
          ]
        },
        "addressString": "text",
        "name": "text"
      }
    ],
    "ipforwarding": true,
    "isdefault": true,
    "isdocker": true,
    "isk8s": true,
    "isstatic": true,
    "isstaticport": true,
    "listenport": 1,
    "macaddress": [
      1
    ],
    "mtu": 1,
    "name": "text",
    "nat_type": "text",
    "nodes": [
      "text"
    ],
    "os": "text",
    "persistentkeepalive": 1,
    "publickey": [
      1
    ],
    "traffickeypublic": [
      1
    ],
    "turn_endpoint": {},
    "verbosity": 1,
    "version": "text",
    "wg_public_listen_port": 1
  },
  "server_config": {
    "Is_EE": true,
    "api": "text",
    "apiport": "text",
    "broker": "text",
    "brokerType": "text",
    "coreDNSAddr": "text",
    "defaultDomain": "text",
    "dnsmode": "text",
    "endpointDetection": true,
    "manageDNS": true,
    "metricInterval": "text",
    "metricsPort": 1,
    "mqpassword": "text",
    "mqport": "text",
    "mquserName": "text",
    "server": "text",
    "stun": true,
    "stunServers": "text",
    "trafficKey": [
      1
    ],
    "version": "text"
  }
}