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-URL>/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 Cannot be blank. |
tags | array of one string, or an empty array | Sanctioned | Unsanctioned | <blank> | Optional. |
Example Add App Instance Request
POST 'https://<tenant-URL>/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"
]
},
]
}