Skip to main content
POST
/
api
/
v2
/
secret-rotations
/
unix-linux-local-account
cURL
curl --request POST \
  --url https://us.infisical.com/api/v2/secret-rotations/unix-linux-local-account \
  --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>",
    "passwordRequirements": {
      "length": 125.5,
      "required": {
        "digits": 1,
        "lowercase": 1,
        "uppercase": 1,
        "symbols": 1
      },
      "allowedSymbols": "<string>"
    },
    "rotationMethod": "login-as-target"
  },
  "secretsMapping": {
    "username": "<string>",
    "password": "<string>"
  },
  "description": "<string>",
  "isAutoRotationEnabled": true,
  "rotateAtUtc": {
    "hours": 11.5,
    "minutes": 29.5
  },
  "temporaryParameters": {
    "password": "<string>"
  }
}
'
{
  "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": "ssh",
      "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": "unix-linux-local-account",
    "parameters": {
      "username": "<string>",
      "passwordRequirements": {
        "length": 125.5,
        "required": {
          "digits": 1,
          "lowercase": 1,
          "uppercase": 1,
          "symbols": 1
        },
        "allowedSymbols": "<string>"
      },
      "rotationMethod": "login-as-target"
    },
    "secretsMapping": {
      "username": "<string>",
      "password": "<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 Unix/Linux Local Account Rotations to learn how to obtain the required parameters.

Body

application/json
​
name
string
required

The name of the Unix/Linux Local Account 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 SSH 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 Unix/Linux Local Account 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.

​
temporaryParameters
object

Response

Default Response

​
secretRotation
object
required