Skip to main content

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 | update | delete | list

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.

For information on creating instance ID for your apps, see this article in the Netskope support page.

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: