Netskope Help

Add an App Instance

This endpoint adds a new app instance. Size limit is 500 app instances max per request with the rate limit of one request every 10 minutes.

Request Endpoint
POST https://<tenant-name>.goskope.com/api/v1/app_instances?token=<token>&op=add

Valid parameters are:

Key

Type

Value

Description

op

string

add

Required. Operation performed.

app

string

Ex:

Amazon Web Services | Amazon S3 | Amazon EC2 | Amazon DynamoDB | Microsoft Azure | Microsoft Office 365 Sharepoint Sites | Microsoft Office 365 OneDrive for Business | Box | Slack 

Required. Name of the application. 

instance_id

string

Ex: 123451234512

Required. For AWS, use the account ID. For Azure, use the Subscription. For GCP, use the Project.

instance_name

string

Ex: "MYAWS_GOSKOPE"

Required. Must be a unique name.

Note

Name should be unique within app + instance_id or app + instance_name.

Cannot be blank.

tags

array of one string, or an empty array

Sanctioned | Unsanctioned | <blank>

Optional.

Example Add App Instance Request
POST 'https://<tenant-name>.goskope.com/api/v1/app_instances?token=<token>&op=add' \
--header 'Content-Type: application/json' \
--data-raw '{
   { "instances":[
	{
		"app":"Box",
		"instance_id": "netskope",
		"instance_name":"Box-Sacntioned-Instance",
		"tags":[
			"Sanctioned"
		]
		},
		{
			"app":"Amazon S3",
			"instance_id": "123451234512",
			"instance_name":"S3-Unsanctioned",
			"tags":[
				"Unsanctioned"
			]
		},
	
	]
}
In this section: