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-URL>/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 |
instance_name | string | Ex: "MYAWS_GOSKOPE" | Required. Used to change instance name, and must be new. Note Name should be unique within |
tags | array of one string, or an empty array | Sanctioned | Unsanctioned | <blank> | Required. |
Example Update App Instance Request
POST 'https://<tenant-URL>/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"
]
}
]
}'