---
title: "Update AWS Credential"
method: PATCH
path: "/v1/credentials/aws/{awsCredentialId}"
tags: ["Cloud"]
---

# Update AWS Credential

`PATCH /v1/credentials/aws/{awsCredentialId}`

Update an existing credential for AWS.

## Path parameters

- `awsCredentialId` string, required — AWS credential ID

## Request body

- UpdateAwsCredentialRequest
  - `arn` string — When provided, the AWS resource identifier with which the trust relationship was formed via the externalId
  - `name` string — When provided, the name to give the credential
  - `orgMemberAccountRoleName` string — When provided, the IAM role that exists in each of your AWS member accounts to be included by Lucid when making requests on your behalf

## Response `200`

OK. Returns the updated AWS credential.

- AwsCredentialObject
  - `credentialId` string, required — AWS credential ID
  - `type` 'aws', required
  - `params` object, required
    - `name` string, required — Name of the credential
    - `arn` string, required — The AWS resource identifier corresponding to the credential
    - `orgMemberAccountRoleName` string, required — If not null, then the IAM role that exists in each of your AWS member accounts that was included by Lucid when making requests on your behalf to create or update the credential

## Other responses

- `403` — Forbidden. Occurs when the credential was not found or the user does not have access to it.

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/revisions/6a32cb9e1aa7/schema)
