Skip to main content
POST
/
api
/
v2
/
secret-rotations
/
aws-iam-user-secret
cURL
curl --request POST \
  --url https://us.infisical.com/api/v2/secret-rotations/aws-iam-user-secret \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "projectId": "<string>",
  "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "environment": "<string>",
  "secretPath": "<string>",
  "rotationInterval": 2,
  "parameters": {
    "userName": "<string>",
    "region": "us-east-1"
  },
  "secretsMapping": {
    "accessKeyId": "<string>",
    "secretAccessKey": "<string>"
  },
  "description": "<string>",
  "isAutoRotationEnabled": true,
  "rotateAtUtc": {
    "hours": 11.5,
    "minutes": 29.5
  }
}
'
{
  "secretRotation": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "folderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "rotationInterval": 123,
    "rotationStatus": "<string>",
    "lastRotationAttemptedAt": "2023-11-07T05:31:56Z",
    "lastRotatedAt": "2023-11-07T05:31:56Z",
    "connection": {
      "app": "aws",
      "name": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "environment": {
      "slug": "<string>",
      "name": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "projectId": "<string>",
    "folder": {
      "id": "<string>",
      "path": "<string>"
    },
    "rotateAtUtc": {
      "hours": 11.5,
      "minutes": 29.5
    },
    "type": "aws-iam-user-secret",
    "parameters": {
      "userName": "<string>",
      "region": "us-east-1"
    },
    "secretsMapping": {
      "accessKeyId": "<string>",
      "secretAccessKey": "<string>"
    },
    "description": "<string>",
    "isAutoRotationEnabled": true,
    "activeIndex": 0,
    "lastRotationJobId": "<string>",
    "nextRotationAt": "2023-11-07T05:31:56Z",
    "isLastRotationManual": true,
    "lastRotationMessage": "<string>"
  }
}
Check out the configuration docs for AWS IAM User Secret Rotations to learn how to obtain the required parameters.

Body

application/json
​
name
string
required

The name of the AWS IAM User Secret Rotation to create. Must be slug-friendly.

Required string length: 1 - 64
​
projectId
string
required

The ID of the project to create the rotation in.

Minimum string length: 1
​
connectionId
string<uuid>
required

The ID of the AWS Connection to use for rotation.

​
environment
string
required

The slug of the project environment to create the rotation in.

Required string length: 1 - 64
​
secretPath
string
required

The secret path of the project to create the rotation in.

Minimum string length: 1
​
rotationInterval
number
required

The interval, in days, to automatically rotate secrets.

Required range: x >= 1
​
parameters
object
required
​
secretsMapping
object
required
​
description
string | null

An optional description for the AWS IAM User Secret Rotation.

Maximum string length: 256
​
isAutoRotationEnabled
boolean
default:true

Whether secrets should be automatically rotated when the specified rotation interval has elapsed.

​
rotateAtUtc
object

The hours and minutes rotation should occur at in UTC. Defaults to Midnight (00:00) UTC.

Response

Default Response

​
secretRotation
object
required