Skip to main content

Netskope Help

Update an App Instance

This endpoint updates an existing 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=update

Valid parameters are:

Key

Type

Value

Description

op

string

update

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.

The app + instance_id combo must be new.

instance_name

string

Ex: "MYAWS_GOSKOPE"

Required. Used to change instance name, and must be new.

Note

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

tags

array of one string, or an empty array

Sanctioned | Unsanctioned | <blank>

Required.

Example Update App Instance Request
POST 'https://<tenant-name>.goskope.com/api/v1/app_instances?token=<token>&op=update' \
--header 'Content-Type: application/json' \
--data-raw '{
   "instances":[
    	{
			"instance_id": "123451234512",
			"instance_name":"New Instance-3",
			"app":"Box",
			"tags":[
				"Sanctioned"
			]
		},
		{
			"instance_id": "123451234512",
			"instance_name":"New Instance-4",
			"app":"Amazon EC2",
			"tags":[
				"Unsanctioned"
			]
		}
	]
}'