Modify the specified AWS configuration object using the provided parameters. 

NOTE: APIs for AWS configs apply only to instances of the that are hosted on AWS and configured for user mode of authentication. These configuration objects can be assigned to individual users as needed.

For more information on how to use awsConfig objects, see API Workflow - Manage AWS Configurations.

Version:  v4

Required Permissions


Request Type: PUT




<id>Internal identifier for the AWS configuration object

Request URI - Example:


The request body contains the parameters of the awsConfigs object that you wish to modify. You do not have to include parameters that are not being modified.

Request Body - bucket assignment:

The following changes the default bucket for the AWS configuration object.



Response Status Code - Success:  200 - OK

Response Body Example:

    "extraBuckets": [
    "id": 2,
    "defaultBucket": "testing2",
    "credentialProvider": "default",
    "externalId": null,
    "activeRoleId": null,
    "createdAt": "2019-04-16T19:48:47.075Z",
    "updatedAt": "2019-04-16T19:48:47.153Z",
    "credential": {
        "id": 21


For more information, see API AWSConfigs Get v4.