Register a new server

POST

/system/servers

curl --request POST \
  --url https://example.com/api/v1/system/servers \
  --header 'Content-Type: application/json' \
  --cookie grommunioAuthJwt=<grommunioAuthJwt> \
  --data '{ "hostname": "example", "extname": "example" }'

• Default deployment path

Authorizations

• JWTCookie

Parameters

Header Parameters

X-Csrf-Token

string

CSRF Token

Request Body

Media typeapplication/json

object

ID

Unique ID of the object

integer

hostname

Internal hostname of the server

string

extname

External address of the server

string

users

Number of users on the server

integer

domains

Number of domains on the server

integer

Example^generated

{
  "hostname": "example",
  "extname": "example"
}

Responses

201

Server registered

Media typeapplication/json

object

ID

Unique ID of the object

integer

hostname

Internal hostname of the server

string

extname

External address of the server

string

users

Number of users on the server

integer

domains

Number of domains on the server

integer

Example^generated

{
  "hostname": "example",
  "extname": "example"
}

400

Validation of input parameters failed

Media typeapplication/json

object

message

string

errors

List of errors encountered during validation

Array<string>

Example^generated

{
  "message": "example",
  "errors": [
    "example"
  ]
}

500

An error occurred while processing the request

Media typeapplication/json

object

message

String representation of the exception

string

Example^generated

{
  "message": "example"
}

503

The database query failed

Media typeapplication/json

object

message

Description of the error

string

Example^generated

{
  "message": "example"
}