FortiPortal 7.2.4 REST API Guide
FortiPortal 7.2.4 REST API Guide
FortiPortal 7.2.4
FORTINET DOCUMENT LIBRARY
https://docs.fortinet.com
FORTINET BLOG
https://blog.fortinet.com
FORTIGUARD LABS
https://www.fortiguard.com
FEEDBACK
Email: [email protected]
Change Log 5
Introduction 6
REST API background 6
Using the API 7
Accessing the API 7
Headers 7
URL parameters 7
JSON payload parameters 7
Success response structure 8
Failure response structure 8
Authentication 8
API HTTP response codes 9
API reference 10
Account 10
List all organizations 11
Get organization general info 12
Create a new organization 13
Delete organizations 14
Update general information for an organization 14
Get organization contact information 16
Update contact information for an organization 17
Get organization users 18
Create organization user 20
Update organization user 21
Delete organization users 23
Get profiles 23
Create a profile 24
Get installs 26
Get install 27
Device 28
List all ADOMs 28
Edit ADOMs assigned to an organization 30
Get report templates 31
Assign report templates 32
Unassign report templates from an organization 33
List all sites for an organization 33
List all sites for an organization in simple format 36
Get a site 38
Create a site 40
Edit a site 41
Delete site 43
Get VDOMs of an organization site 43
Get available VDOMs of an organization's site 46
Update a VDOM alias 50
System 51
A RESTful API uses standard HTTP methods (GET, POST, DELETE, etc.) to provide interactions between a client and a
server. The API is stateless and each request is independent.
The following operations are supported by a RESTful API:
1. Fetch data by sending a GET request.
2. Add data by sending a POST request.
3. Update data by sending a PATCH, PUT, or POST request.
4. Delete data by sending a DELETE request.
This chapter provides details on accessing and authenticating the FortiPortal API.
See Accessing the API on page 7 and Authentication on page 8.
Headers
URL parameters
FortiPortal API follows the standard REST format for the request URLs.
In a request to get all entries of a collection, or to add a new entry to a collection, the URL includes the collection name.
In a request to get, update or delete a specific member of a collection, the URL includes the collection name and the
index of the specific entry. For a nested collection (such as organization sites), the URL may contain more than one
index (one for organization ID, one for site ID).
The URL parameters are always mandatory. If you do not provide a valid ID for each index in the request URL, the
request will result in a failure response.
In the methods to add a new entry or update an existing entry in a collection, the payload contains the input fields for the
entry. The payload information is sent as text in JSON format.
Some input fields are required, and some are optional. You must provide values for the required fields. The
API reference lists the required and optional fields for each API method.
Authentication
To initiate REST API requests, you must first log in to FortiPortal and acquire an API key.
The authorization key must be included in all subsequent API requests in the Authorization header. The key expires
in one hour.
Acquiring a new key does not expire any other generated keys.
ttl_days N Length of time, in days, that the token is valid. Maximum 30.
ttl_hours N Length of time, in hours, that the token is valid. Maximum 23.
ttl_minutes N Length of time, in minutes, that the token is valid. Maximum 59.
JSON response:
{
"expiry": null,
"token": "138f1bc8865ba7659b86eff57533e90815406fdd1dd0d38f838100f469f2788d"
}
Parameter Description
The API returns an HTTP status code to indicate the disposition of the request:
403 Forbidden Request is missing the CSRF token or administrator is missing access profile
permissions.
405 Method Not Allowed Specified HTTP method is not allowed for this resource.
500 Internal Server Error Internal server error. Check the audit log for more information, if available.
This chapter provides details about each of the API methods. You must acquire a token from the FortiPortal GUI before
using the API methods.
See Authentication on page 8 for more information.
Account
Arguments
None
Outputs
results JSON array Array of organizations. One entry per organization, each record
contains a unique ID.
Example request
Example response
{
"data" : {
"results" : [
{
"adom_version_num" : [],
"device_count" : 0,
"id" : 1,
"name" : "TeSt2",
"reports" : {
"assigned" : 0,
"total" : 0
},
"site_count" : 0,
"status" : []
}
],
"totalResultsCount" : 1
},
"status" : {
"code" : 0,
"message" : "success"
}
}
Arguments (URL)
Outputs
Example request
Example response
{
"blocked_host_enabled" : false,
"email" : "[email protected]",
"first_name" : "aaa",
"global_two_factor_enabled" : false,
"last_name" : "bbb",
"locale" : "en",
"logo_image" : null,
"name" : "TeSt2",
"policy_installation_scheduler" : null,
"policy_installation_time" : null,
"policy_installation_weekday" : null,
"sso_domains" : [],
"trusted_host_enabled" : false,
"use_mssp_locale" : false,
"validate_sso_domain_pattern" : false
Outputs
Example request
Example response
{
"email" : "[email protected]",
"first_name" : "aaa",
"id" : 1,
"last_name" : "bbb",
"name" : "TeSt2"
Delete organizations
Outputs
None.
Example request
Arguments (URL)
Outputs
Example request
Example response
{
"blocked_host_enabled" : false,
"email" : "[email protected]",
"first_name" : "aaa",
"global_two_factor_enabled" : false,
"last_name" : "bbb",
"locale" : "en",
"logo_image" : null,
"name" : "TeSt2",
"policy_installation_scheduler" : null,
"policy_installation_time" : null,
"policy_installation_weekday" : null,
"sso_domains" : [],
"trusted_host_enabled" : false,
"use_mssp_locale" : false,
"validate_sso_domain_pattern" : false
}
Arguments (URL)
Outputs
Example request
Example response
{
"address1" : "",
"address2" : "",
"city" : "",
"country" : "",
"fax" : "",
"name" : "TeSt2",
"phone" : "",
"state" : "",
"zip" : ""
}
Arguments (URL)
Outputs
Example request
Example response
{
"address1" : "123",
"address2" : "",
"city" : "",
"country" : "",
"fax" : "",
"name" : "New Name",
"phone" : "",
"state" : "",
"zip" : ""
}
GET account/organization/users/ List all users for a particular Organization JSON array
organization unique identifier
None
Outputs
results JSON array Array of organization user records. One entry per organization user,
each record contains a unique user ID.
Example request
Example response
{
"results" : [
{
"address1" : "",
"address2" : "",
"auth_backend" : "local",
"city" : "",
"country" : "",
"customer" : 1,
"email" : "[email protected]",
"fax" : "",
"first_name" : "Test",
"global_two_factor_enabled" : false,
"id" : 15,
"is_active" : true,
"last_name" : "User",
"phone" : "",
"pwdEnable" : false,
"pwdLength" : 8,
"pwdLowercase" : false,
"pwdNumbers" : false,
"pwdSpecialcharacters" : false,
"pwdUppercase" : false,
"role" : {
"id" : 2,
"name" : "Customer Admin",
"service_provider" : 1,
"service_type" : "Customer"
},
"service_provider" : 1,
"sites" : [
2
],
"state" : "",
"two_factor_enabled" : false,
"username" : "[email protected]",
"zip" : ""
}
],
"size" : 10,
"start" : 0,
"totalResultsCount" : 1
}
two_factor_enabled bool Set to false. Users with two-factor authentication enabled cannot be
created through the API.
Outputs
Example request
Example response
{
"address1" : "",
"address2" : "",
"auth_backend" : "local",
"city" : "",
"country" : "",
"customer" : 4,
"email" : "",
"fax" : "",
"first_name" : "",
"global_two_factor_enabled" : false,
"id" : 16,
"is_active" : true,
"last_name" : "",
"phone" : "",
"pwdEnable" : false,
"pwdLength" : 8,
"pwdLowercase" : false,
"pwdNumbers" : false,
"pwdSpecialcharacters" : false,
"pwdUppercase" : false,
"role" : 2,
"service_provider" : 1,
"sites" : [
2
],
"state" : "",
"two_factor_enabled" : false,
"username" : "another_test_user",
"zip" : ""
}
Arguments (URL)
Outputs
Example request
Example response
{
"address1" : "",
"address2" : "",
"auth_backend" : "local",
"city" : "",
"country" : "",
"customer" : 4,
"email" : "",
"fax" : "",
"first_name" : "Testing",
"global_two_factor_enabled" : false,
"id" : 1,
"is_active" : true,
"last_name" : "",
"phone" : "555-555-5555",
"pwdEnable" : false,
"pwdLength" : 8,
"pwdLowercase" : false,
"pwdNumbers" : false,
"pwdSpecialcharacters" : false,
"pwdUppercase" : false,
"role" : 2,
"service_provider" : 1,
"sites" : [
2
],
"state" : "",
"two_factor_enabled" : false,
"username" : "another_test_user",
"zip" : ""
}
Arguments
Outputs
None.
Example request
Get profiles
Arguments
None
Outputs
Example request
Example response
{
"results" : [
{
"create_type" : "Default",
"id" : 1,
"name" : "Admin",
"permissions" : [
2,
4,
7,
...
],
"service_provider" : 1,
"service_type" : "Provider"
},
...
}
],
"size" : 10,
"start" : 0,
"totalResultsCount" : 3
}
Create a profile
Outputs
Permissions
For details about permission IDs, see Access Permissions on page 53.
Example request
Example response
{
"create_type" : "Custom",
"id" : 4,
"name" : "testtest",
"permissions" : [
1,
2,
3
],
"service_provider" : 1,
"service_type" : "Provider"
}
Get installs
Arguments (URL)
Arguments (Query)
startdate datetime The range start date and time in one of the following formats:
l %Y-%m-%d %H:%M:%S
l %Y-%m-%d %H:%M
enddate datetime The range end date and time in one of the following formats:
l %Y-%m-%d %H:%M:%S
l %Y-%m-%d %H:%M
Outputs
Example request
Example response
[
{
"id": 1,
"task_id": 815,
"task_details": "Policy package FortiWiFi-61E-64-SDWAN-WiFi_root installed to device
FortiWiFi-61E-64-SDWAN-WiFi and vdom root started with taskId 815.",
"user_id": 2,
"user_name": "[email protected]",
"device_id": 187,
"device_name": "FortiWiFi-61E-64-SDWAN-WiFi",
"vdom_name": "root",
"package_name": "FortiWiFi-61E-64-SDWAN-WiFi_root",
"adom_name": "QALAB_ADOM_647_SDWAN_WiFi",
"fortimanager_id": 2,
"created_on": "2023-07-18T11:49:02.834010-07:00",
"customer_id": 1
}
]
Get install
Arguments (URL)
Outputs
Example request
Example response
{
"install_id": 1,
"task_id": 815,
"customer_id": 1,
"customer_name": "test",
"installation_log": "\n\nStarting log (Run on device)\n\n\nStart installing\n\nNo
commands to be installed\n\ninstall finished\n",
"error_code": "0",
"error_msg": "Get Install Log Successfully"
}
Device
GET device/site/customer/{Organization ID}/ List all sites for an organization in simple format on page
36
Arguments
None
Outputs
results JSON array Array of ADOMs. One entry per ADOM, each record contains a
unique ID.
Example request
Example response
{
"data" : {
"results" : [
{
"customer" : [],
"flags" : "no_vpn_console",
"fortimanager" : {
"ha" : false,
"host" : "XXX.XXX.XXX.XXX",
"id" : 1,
"last_poll_time" : "2022-09-12T17:34:44.133713Z",
"name" : "FMG1",
"numericVersion" : "7.0.4",
"polling" : 50,
"port" : 443,
"sn" : "FMG-VMTMXXXXXXX",
"status" : true,
"username" : "fortiportal",
"version" : "v7.0.4-build0306 220608 (GA)",
"xmlPort" : 8080
},
"id" : 2,
"name" : "root",
"oid" : 3,
"version" : "7.0"
},
...
],
"totalResultsCount" : 2
},
"status" : {
"code" : 0,
"message" : "success"
}
}
Arguments (URL)
adoms array A list of ADOM IDs assigned to the organization. Include IDs to be
added, omit IDs to be removed.
Outputs
Example request
Example response
{
"status" : {
"code" : 0,
"message" : "success"
}
}
Arguments (URL)
None.
Outputs
results JSON array Array of report templates. One entry per template, each record
contains a unique ID.
Example request
Example response
{
"data" : {
"results" : [
{
"adom" : "FortiSandbox",
"customer" : [],
"fortianalyzer" : {
"host" : "XXX.XXX.XXX.XXX",
"id" : 1,
"last_poll_time" : "2022-09-12T21:31:45.259031Z",
"name" : "FPC-",
"numericVersion" : "7.0.4",
"polling" : 51,
"port" : 443,
"sn" : "FAZ-VMTMXXXXXXXX",
"status" : true,
"username" : "fortiportal",
"version" : "v7.0.4-build0306 220608 (GA)"
},
"id" : 1,
"name" : "FortiSandbox Default Report"
},
...
],
"totalResultsCount" : 73
},
"status" : {
"code" : 0,
"message" : "success"
}
}
Arguments (URL)
None.
Arguments
Outputs
Example request
Example response
{
"status" : {
"code" : 0,
"message" : "success"
}
}
Arguments (URL)
None.
Arguments
Outputs
Example request
Example response
{
"status" : {
"code" : 0,
"message" : "success"
}
}
GET device/site/list/customer/ List all sites for this Organization ID JSON array
{Organization ID}/ organization
Arguments (URL)
None
Outputs
results JSON array Array of site records. One entry per site, each record contains a
unique ID.
Example request
Example response
{
"data": {
"totalResultsCount": 1,
"results": [
{
"id": 6,
"vdoms": [
{
"id": 16,
"fortimanager": {
"id": 4,
"name": "FMG-7.2-11",
"host": "10.5.1.11",
"username": "fpc",
"status": true,
"last_poll_time": "2023-06-30T01:30:00.932838Z",
"port": 443,
"xmlPort": 8080,
"sn": "FMG-VMTMXXXXXXXX",
"version": "v7.2.3-build1405 230606 (GA)",
"numericVersion": "7.2.3",
"ha": false,
"polling": 51
},
"fortianalyzer": {
"id": 4,
"numericVersion": "7.2.3",
"name": "FAZ-7.2-31",
"host": "10.5.1.31",
"username": "fpc",
"status": true,
"last_poll_time": "2023-06-30T01:30:02.022982Z",
"port": 443,
"sn": "FAZ-VMTMXXXXXXXX",
"version": "v7.2.3-build1405 230606 (GA)",
"polling": 51
},
"adom": {
"id": 17,
"fortimanager": {
"id": 4,
"name": "FMG-7.2-11",
"host": "10.5.1.11",
"username": "fpc",
"status": true,
"last_poll_time": "2023-06-30T01:30:00.932838Z",
"port": 443,
"xmlPort": 8080,
"sn": "FMG-VMTMXXXXXXXX",
"version": "v7.2.3-build1405 230606 (GA)",
"numericVersion": "7.2.3",
"ha": false,
"polling": 51
},
"name": "root",
"oid": 3,
"version": "7.2",
"flags": "no_vpn_console",
"customer": [
10
]
},
"policypackage": {
"id": 20,
"name": "FGT-41",
"status": "imported",
"isEnable": true
},
"aps": [],
"switches": [],
"extenders": [],
"name": "root",
"sn": "FGVM08TMXXXXXXXX",
"devid": "FGT-41",
"alias": "",
"vdom_oid": 3,
"device_oid": 197,
"version": "7.2.5",
"platform": "FortiGate-VM64",
"status": "synchronized",
"device_ha": false,
"device_ha_info": "",
"latitude": 49.28273,
"longitude": -123.120743,
"fortigate_name": "FGT-41",
"display_name": "root/FGT-41/root",
"site": 6
}
],
"aps": [],
"switches": [],
"extenders: [],
"name": "test-site-7.2",
"contactName": "",
"email": "",
"phone": "",
"sandbox": false,
"customer": 10,
"user": [
12
]
}
]
},
"status": {
"code": 0,
"message": "success"
}
}
GET device/site/customer/{Organization List all sites for this Organization ID JSON array
ID}/ organization in simple
format
Arguments (URL)
None
Outputs
results JSON array Array of site records. One entry per site, each record contains a
unique ID.
Example request
Example response
{
"data": {
"totalResultsCount": 2,
"results": [
{
"id": 6,
"name": "test-site-7.2",
"contactName": "",
"email": "",
"phone": "",
"sandbox": false,
"customer": 10,
"user": [
12
]
},
{
"id": 8,
"name": "test-site-7.4",
"contactName": "",
"email": "",
"phone": "",
"sandbox": false,
"customer": 10,
"user": [
12
]
}
]
},
"status": {
"code": 0,
"message": "success"
}
}
Get a site
Arguments (URL)
None.
Outputs (site)
Example request
Example response
{
"data" : {
"aps" : [],
"contactName" : "",
"customer" : 1,
"email" : "",
"extenders" : [],
"id" : 1,
"name" : "site1",
"phone" : "",
"sandbox" : false,
"switches" : [],
"user" : [],
"vdoms" : [
{
"adom" : {
"customer" : [
1
],
"flags" : "no_vpn_console",
"fortimanager" : {
"certificate_validation" : false,
"ha" : false,
"ha_vrrp" : false,
"ha_vrrp_primary_ip" : null,
"host" : "XXX.XXX.XXX.XXX",
"id" : 3,
"last_poll_time" : "2023-12-13T23:04:56.594250Z",
"name" : "FMG1",
"numericVersion" : "7.4.1",
"polling" : 52,
"port" : 443,
"selected_certificate" : null,
"sn" : "FMG-VMTMXXXXXXX",
"status" : true,
"username" : "fortiportal",
"version" : "v7.4.1-build2308 230831 (GA)",
"xmlPort" : 8080
},
"id" : 7,
"name" : "72",
"oid" : 169,
"version" : "7.2"
},
"alias" : "",
"aps" : [],
"device_ha" : false,
"device_ha_info" : "",
"device_oid" : 165,
"devid" : "FPC-FGT1",
"display_name" : "72/FPC-FGT1/root",
"extenders" : [],
"fortianalyzer" : null,
"fortigate_name" : "FPC-FGT1",
"fortimanager" : {
"certificate_validation" : false,
"ha" : false,
"ha_vrrp" : false,
"ha_vrrp_primary_ip" : null,
"host" : "192.168.1.55",
"id" : 3,
"last_poll_time" : "2023-12-13T23:04:56.594250Z",
"name" : "FMG1",
"numericVersion" : "7.4.1",
"polling" : 52,
"port" : 443,
"selected_certificate" : null,
"sn" : "FMG-VMTMXXXXXXX",
"status" : true,
"username" : "fortiportal",
"version" : "v7.4.1-build2308 230831 (GA)",
"xmlPort" : 8080
},
"id" : 1,
"latitude" : XXX,
"longitude" : XXX,
"name" : "root",
"platform" : "FortiGate-VM64-KVM",
"policypackage" : null,
"site" : 1,
"sn" : "FGVMULTMXXXXXXXX",
"status" : "modified",
"switches" : [],
"vdom_oid" : 3,
"version" : "7.2.6"
}
]
},
"status" : {
"code" : 0,
"message" : "success"
}
}
Create a site
Arguments (URL)
None.
Outputs
Example request
Example response
{
"status" : "success",
"id": 3,
"data": {
"id" : 3,
"vdoms" : []
"aps" : [],
"switches" : [],
"name" : "site3",
"contactName" : "aaa",
"email" : "[email protected]",
"phone" : "",
"sandbox" : false,
"customer" : 1,
"user" : [],
}
}
Edit a site
Arguments (URL)
Outputs
Example request
Example response
{
"status" : {
"code" : 0,
"message" : "success"
}
}
Delete site
Arguments (URL)
None
Outputs
None.
Example request
Example response
{
}
Arguments (URL)
None
Outputs
results JSON array VDOM information for the specified organization site
Example request
Example response
{
"data" : {
"results" : [
{
"adom" : {
"customer" : [
1
],
"flags" : "no_vpn_console",
"fortimanager" : {
"ha" : false,
"host" : "XXX.XXX.XXX.XXX",
"id" : 1,
"last_poll_time" : "2022-09-12T17:46:59.828879Z",
"name" : "FMG1",
"numericVersion" : "7.0.4",
"polling" : 51,
"port" : 443,
"sn" : "FMG-VMTMXXXXXXX",
"status" : true,
"username" : "fortiportal",
"version" : "v7.0.4-build0306 220608 (GA)",
"xmlPort" : 8080
},
"id" : 2,
"name" : "root",
"oid" : 3,
"version" : "7.0"
},
"alias" : "",
"device_ha" : false,
"device_ha_info" : "",
"device_oid" : 160,
"devid" : "FPC-FGT1",
"fortianalyzer" : null,
"fortigate_name" : "FPC-FGT1",
"fortimanager" : {
"ha" : false,
"host" : "XXX.XXX.XXX.XXX",
"id" : 1,
"last_poll_time" : "2022-09-12T17:46:59.828879Z",
"name" : "FMG1",
"numericVersion" : "7.0.4",
"polling" : 51,
"port" : 443,
"sn" : "FMG-VMTMXXXXXXX",
"status" : true,
"username" : "fortiportal",
"version" : "v7.0.4-build0306 220608 (GA)",
"xmlPort" : 8080
},
"id" : 1,
"latitude" : XX.XXXX,
"longitude" : XX.XXX,
"name" : "root",
"organization" : {
"id" : 1,
"name" : "Org1"
},
"platform" : "FortiGate-VM64-KVM",
"policypackage" : null,
"site" : 3,
"sn" : "FGVMXXXXXXXXXX",
"status" : "Synchronized",
"vdom_oid" : 3,
"version" : "7.0.6"
}
],
"totalResultsCount" : 1
},
"status" : {
"code" : 0,
"message" : "success"
}
}
Arguments (URL)
None
Outputs
Example request
Example response
{
"data" : {
"results" : [
{
"adom" : {
"customer" : [
1
],
"flags" : "no_vpn_console",
"fortimanager" : {
"ha" : false,
"host" : "XX.XX.XX.XX",
"id" : 1,
"last_poll_time" : "2023-01-10T18:53:30.475002Z",
"name" : "Org1 FMG",
"numericVersion" : "7.0.4",
"polling" : 51,
"port" : 443,
"sn" : "FMG-VMTMXXXXXXXX",
"status" : true,
"username" : "fortiportal",
"version" : "v7.0.4-build0306 220608 (GA)",
"xmlPort" : 8080
},
"id" : 3,
"name" : "root",
"oid" : 3,
"version" : "7.0"
},
"alias" : "",
"aps" : [],
"device_ha" : false,
"device_ha_info" : "",
"device_oid" : 185,
"devid" : "FPC-FGT1",
"display_name" : "root/FPC-FGT1/root",
"fortianalyzer" : null,
"fortigate_name" : "FPC-FGT1",
"fortimanager" : {
"ha" : false,
"host" : "XX.XX.XX.XX",
"id" : 1,
"last_poll_time" : "2023-01-10T18:53:30.475002Z",
"name" : "Org1 FMG",
"numericVersion" : "7.0.4",
"polling" : 51,
"port" : 443,
"sn" : "FMG-VMTMXXXXXXXX",
"status" : true,
"username" : "fortiportal",
"version" : "v7.0.4-build0306 220608 (GA)",
"xmlPort" : 8080
},
"id" : 1,
"latitude" : XX,
"longitude" : XX,
"name" : "root",
"platform" : "FortiGate-VM64-KVM",
"policypackage" : {
"id" : 2,
"isEnable" : false,
"name" : "FPC-FGT1",
"status" : "unknown"
},
"site" : 1,
"sn" : "FGVM01TMXXXXXXXX",
"status" : "modified",
"switches" : [
{
"alias" : "",
"display_name" : "root/FPC-FGT1/root",
"id" : 1,
"name" : "FSW",
"site" : 1,
"sn" : "S108ENXXXXXXXXX",
"vdom" : {
"adom" : {
"customer" : [
1
],
"flags" : "no_vpn_console",
"fortimanager" : {
"ha" : false,
"host" : "XX.XX.XX.XX",
"id" : 1,
"last_poll_time" : "2023-01-10T18:53:30.475002Z",
"name" : "Org1 FMG",
"numericVersion" : "7.0.4",
"polling" : 51,
"port" : 443,
"sn" : "FMG-VMTMXXXXXXXX",
"status" : true,
"username" : "fortiportal",
"version" : "v7.0.4-build0306 220608 (GA)",
"xmlPort" : 8080
},
"id" : 3,
"name" : "root",
"oid" : 3,
"version" : "7.0"
},
"alias" : "",
"device_ha" : false,
"device_ha_info" : "",
"device_oid" : 185,
"devid" : "FPC-FGT1",
"display_name" : "root/FPC-FGT1/root",
"fortianalyzer" : null,
"fortigate_name" : "FPC-FGT1",
"fortimanager" : {
"ha" : false,
"host" : "XX.XX.XX.XX",
"id" : 1,
"last_poll_time" : "2023-01-10T18:53:30.475002Z",
"name" : "Org1 FMG",
"numericVersion" : "7.0.4",
"polling" : 51,
"port" : 443,
"sn" : "FMG-VMTMXXXXXXXX",
"status" : true,
"username" : "fortiportal",
"version" : "v7.0.4-build0306 220608 (GA)",
"xmlPort" : 8080
},
"id" : 1,
"latitude" : XX,
"longitude" : XX,
"name" : "root",
"organization" : {
"id" : 1,
"name" : "Org1"
},
"platform" : "FortiGate-VM64-KVM",
"policypackage" : {
"id" : 2,
"isEnable" : false,
"name" : "FPC-FGT1",
"status" : "unknown"
},
"site" : 1,
"sn" : "FGVM01TMXXXXXXXX",
"status" : "Modified",
"vdom_oid" : 3,
"version" : "7.0.6"
}
}
],
"vdom_oid" : 3,
"version" : "7.0.6"
}
],
"totalResultsCount" : 1
},
"status" : {
"code" : 0,
"message" : "success"
}
}
Arguments (URL)
None
Outputs
Example request
Example response
{
"status" : {
"code" : 0,
"message" : "success"
}
}
System
Arguments
None
Outputs
JSON array Array of licenses. One entry per license, each record contains a
unique ID.
Example request
Example response
[
{
"device_allowed" : 5000,
"expiry_date" : "2023-07-08T17:11:14Z",
"host" : "XXX.XXX.XXX.XXX",
"id" : 1,
"serial_number" : "FPC-VMTMXXXXXXX",
"status" : "valid"
}
]
Upload a license
Arguments (URL)
None.
Outputs
None.
Example request
Example response
{
}
The tables below list the permission IDs for each component.
Provider
Customer
Provider
audit 15 Read/Write
audit 14 Read
dashboard 1 Read
dashboard 2 Read/Write
devices 8 CUSTOM
devices 7 Read/Write
devices 6 Read
notifications 13 Read/Write
notifications 12 Read
organizations 4 Read/Write
organizations 3 Read
organizations 5 CUSTOM
system 10 Read/Write
system 9 Read
system 11 CUSTOM
Customer
additional_resources 77 Read/Write
additional_resources 76 Read
customer_audit 75 Read/Write
customer_audit 74 Read
insights 57 Read
insights 58 Read/Write
insights 59 CUSTOM
reports 72 Read
reports 73 Read/Write
sdwan 62 CUSTOM
sdwan 60 Read
sdwan 61 Read/Write
security 63 Read
security 64 Read/Write
security 65 CUSTOM
switch 66 Read
switch 67 Read/Write
switch 68 CUSTOM
wifi 71 CUSTOM
wifi 70 Read/Write
wifi 69 Read