Page tree

Release 6.4.2



For the latest updates on available API endpoints and documentation, see

This is the latest version of the APIs.


Modify the specified AWS role object using the provided parameters. 

NOTE: APIs for AWS roles apply only to instances of the Designer Cloud Powered by Trifacta® platform that are hosted on AWS and configured for user mode of authentication.

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


Required Permissions

NOTE: Each request to the Designer Cloud Powered by Trifacta® platform must include authentication credentials. See


Request Type: PUT




<id>Internal identifier for the AWS roles object

Request URI - Example:


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

Request Body - IAM role ARN assignment:

The following changes the IAM role ARN for the AWS Role object.

NOTE: When an AWS role object has been created, it must be assigned to an AWS configuration object. This assignment cannot be modified after creation. You must delete the AWS role object and recreate it.

  "role", "<my_new_iam_role_arn>"


Response Status Code - Success:  200 - OK

Response Body Example:

    "createdFrom": "api",
    "id": 2,
    "role": "<my_new_iam_role_arn>",
    "awsConfig": {
      "id": 1
    "updatedAt": "2019-07-15T23:18:59.360Z",
    "createdAt": "2019-07-15T23:18:59.360Z",
    "deleted_at": null


For more information, see API AWSRoles Get v4.

This page has no comments.