Sysadmin Module GraphQL APIs

Owned by Nathaniel Halbrooks
Dec 01, 2023
6 min read

fetchActivationStatus

 

This wiki is to capture the Sysadmin module provided GraphQL APIs.

 

Sysadmin module APIs are related with "Activating" system with given deployment id , updating license, fetch system information etc.

 

Activate System

Activate system using given deployment ID

API : activateSystem

 

API Parameters: 

 

Name

Required

Type

Default

Description

Name

Required

Type

Default

Description

deploymentID

Mandatory

ID

 

Deployment id to activate the system

 

 

Query Parameters 

status message transaction_id

 

 

API Request 

Gql Endpoint: /admin/api/api/gql   Parameters:   mutation {     activateSystem(input: { deploymentId: "1*******" }) {         status         message         transaction_id     } }

API Response 

{     "data": {         "activateSystem": {             "status": true,             "message: "Activation process has started.Kindly check the fetchApiStatus api with the transaction id.",             transaction_id: "101"           }     } }

Update System License

 

Update the system license of existing activated system.

 

API - updateLicence

API Parameter - None

 

Query Parameters 

 

 

 

API Request 

API Response 

Update Provisioning Port

To update the provisioning port of various services. Applicable only if you have Commercial licensed Sysadmin module.

 

API - updateProvisionPort

API Parameters - 

 

Name

Required

Type

Default

Description

 

Name

Required

Type

Default

Description

adminControlPort

Optional

Integer

80

Specify the HTTPS port for the admin control panel (The interface).

sslAdminControlPort

Optional

Integer

443

Secure Port https for administration for this system.

userControlPort

Optional

Integer

81

Specify the HTTPS port for the user control panel of the system.

sslUserControlPort

Optional

Integer

4443

Secure Port https for administration for user control panel of this system.

httpProvision

Optional

Integer

84

Specify the HTTP Provisioning - Access to provisioning files. Default port 84.

sslHttpProvision

Optional

Integer

1443

Secure Port https for HTTP Provisioning of this system.

restApi

Optional

Integer

83

Specify the HTTPS port for the REST API Provisioning of this system.

sslRestApi

Optional

Integer

2443

Secure Port https for REST API Provisioning of this system.

restApps

Optional

Integer

82

Specify the HTTP port for RESTful Phone Apps of the system.

sslRestApps

Optional

Integer

3443

Secure Port https for RESTful Phone Apps Provisioning of this system.

letsEncryptPort

Optional

String

"disabled"

Only allows access to LetsEncrypt tokens.

sslDefault

Optional

String

"HTTP Only"

Secure Port default HTTP Only.

sslSangomaPhone

Optional

Integer

6443

Secure Port https for Sangoma Phone Desktop Client Service

fqdn

Optional

String

 

PBX address to which the browser will be redirected when force is enabled

 

 

Query Parameters 

 

 

 

API Request 

API Response 

Fetch System Information

 

Get all the system information like Freepbx/PBXact version, Licensed modules, Brand, deployment ID etc.

 

API - fetchLicenceDetails

Query Parameters 

 

 

API Request 

API Response 

 

 

Fetch Activation Status

 

Get all the system information like Freepbx/PBXact.

 

API - fetchActivationStatus

 

 

Query Parameters 

 

 

API Request 

API Response 

 

Add Hostname

Set hostname of the system

API : addHostname

 

API Parameters: 

Name

Required

Type

Default

Description

Name

Required

Type

Default

Description

hostname

Mandatory

String

 

hostname for the system

 

Query Parameters 

 

API Request 

API Response 

Install SSL Certificate 

Set hostname of the system

API : installSSLCertificate

 

API Parameters: 

Name

Required

Type

Default

Description

Name

Required

Type

Default

Description

cid

Mandatory

String

 

Enter the certificate ID, after fetching the SSL certificate

 

Query Parameters 

 

API Request 

API Response 

Update SSL Certificate 

Set hostname of the system

API : updateSSLCertificate

 

API Parameters: 

Name

Required

Type

Default

Description

Name

Required

Type

Default

Description

cid

Mandatory

String

 

Enter the certificate ID, after fetching the SSL certificate

 

Query Parameters 

 

API Request 

API Response 

Fetch Hostname

 

Get all the system information like Freepbx/PBXact.

 

API - fetchHostname

 

Query Parameters 

 

API Request 

API Response 


Fetch SSL Certificates

 

Get all the system information like Freepbx/PBXact.

 

API - fetchSSLCertificates

 

Query Parameters 

 

API Request 

API Response 

Update Provisioning Protocols

 

API - updateProvisioningProtocols

 

API Parameters: 

Name

Required

Type

Default

Description

Name

Required

Type

Default

Description

ftpServer

Optional

Boolean

false

FTP server enable/disable

ftpUsername

Optional

String

 

Username that FTP client will use

ftpPassword

Optional

String

 

Password that FTP client will use

tftpServer

Optional

Boolean

false

TFTP server enable/disable

httpsAuth

Optional

String

 

HTTPS Authentication. Available options are none, both, http, https. Do not add double or single quotes to the value while setting this parameter

httpsAuthUsername

Optional

String

 

HTTPS Username. This is auto-generated if the parameter is blank

httpsAuthPassword

Optional

String

 

HTTPS Password. This is auto-generated if the parameter is blank

 

Query Parameters 

 

API Request 

API Response 

Apache restart

For restart Apache server, we can use same API without using any option.

API - updateProvisioningProtocols

API Example - 

API Request 

API Response 

Fetch Provisioning Protocols

Get all the provision protocols information.

 

API -  fetchProvisioningProtocols

 

Query Parameters 

 

API Request 

API Response 

 

Update SSL Protocol

Get all the SSL protocols information.

 

API -  updateSSLProtocol

API Parameters: 

Name

Required

Type

Default

Description

Name

Required

Type

Default

Description

all

Optional

String

disable

All SSL Protocol enable/disable

SSLV3

Optional

String

disable

SSLV3 Protocol enable/disable

TLSV1

Optional

String

disable

TLSV1 Protocol enable/disable

TLSV1_1

Optional

String

disable

TLSV1_1 Protocol enable/disable

TLSV1_2

Optional

String

enable

TLSV1_2 Protocol enable/disable

Apache restart API

Need to restart Apache then please execute updateProvisioningProtocols API after executing above API.

 

 

Query Parameters 

 

API Request 

 

API Response 

Enable/Disable force

Enable/disable force for different ports

 

API -  updateForcePort

API Parameters

Name

Required

Type

Default

Description

Name

Required

Type

Default

Description

port

Mandatory

string

 

port for which force has to be set as enabled/disabled

force

Mandatory

string

 

yes/no, yes will enable force no will disable force

 

Query Parameters 

 

API Request 

 

API Response 

Fetch Port force options

Fetch force values for the provisioning ports

API -  fetchForce

Query Parameters 

API Request 

API Response 

Return to Documentation Home I Return to Sangoma Support