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. |
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"
]
},
]
}