---
updatedAt: 2026-10-06T17:39:05.000Z
agentTools:
  projectIndex: https://docs.akeyless.io/llms.txt
---

# /rotated-secret-create-postgresql

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "contact": {
      "email": "support@akeyless.io",
      "name": "Akeyless",
      "url": "http://akeyless.io"
    },
    "description": "The purpose of this application is to provide access to Akeyless API.",
    "title": "Secrets & keys",
    "version": "3.0"
  },
  "paths": {
    "/rotated-secret-create-postgresql": {
      "post": {
        "operationId": "rotatedSecretCreatePostgresql",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/rotatedSecretCreatePostgresql"
              }
            }
          },
          "required": true,
          "x-go-name": "Body"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/rotatedSecretCreatePostgresqlResponse"
          },
          "default": {
            "$ref": "#/components/responses/errorResponse"
          }
        },
        "tags": [
          "Rotated Secrets"
        ],
        "x-docs-category": "Secrets & keys",
        "x-docs-group": "Rotated Secrets"
      }
    }
  },
  "tags": [
    {
      "name": "Rotated Secrets"
    }
  ],
  "x-readme": {
    "apply-tag-changes": true
  },
  "servers": [
    {
      "url": "https://api.akeyless.io"
    }
  ],
  "components": {
    "responses": {
      "errorResponse": {
        "description": "errorResponse wraps any error to return it as a JSON object with one \"error\"\nfield.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/JSONError"
            }
          }
        }
      },
      "rotatedSecretCreatePostgresqlResponse": {
        "description": "rotatedSecretCreatePostgresqlResponse wraps response body.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/rotatedSecretCreateOutput"
            }
          }
        }
      }
    },
    "schemas": {
      "JSONError": {
        "properties": {
          "error": {
            "type": "string",
            "x-go-name": "Err"
          }
        },
        "title": "JSONError wraps an error with JSON object.",
        "type": "object",
        "x-go-package": "akeyless.io/akeyless-main-repo/go/src/client"
      },
      "StringOrBool": {
        "description": "StringOrBool accepts JSON strings, booleans, and numbers for backward\ncompatibility with older SDK versions that send boolean values for\nrotate-after-disconnect.",
        "type": "string",
        "x-go-package": "akeyless.io/akeyless-main-repo/go/src/client"
      },
      "rotatedSecretCreateOutput": {
        "properties": {
          "name": {
            "type": "string",
            "x-go-name": "Name"
          }
        },
        "type": "object",
        "x-go-package": "akeyless.io/akeyless-main-repo/go/src/client/commands"
      },
      "rotatedSecretCreatePostgresql": {
        "properties": {
          "ara-enabled": {
            "description": "Enable or disable Agentic Runtime Authority rule enforcement for this item.\nWhen false, user-defined input/output rules are stored but not enforced;\nthe base security validation still runs.\n\nAraEnabled is tri-state (nil/true/false), not a plain bool: it self-encodes\nits wire value (see akl.OptionalBool) so an explicit false survives the\ncurl-proxy relay instead of being dropped like a default-false bool flag.",
            "type": "boolean",
            "x-go-name": "AraEnabled"
          },
          "authentication-credentials": {
            "default": "use-user-creds",
            "description": "The credentials to connect with use-user-creds/use-target-creds",
            "type": "string",
            "x-go-name": "RotatorCredsType"
          },
          "auto-rotate": {
            "type": "string",
            "x-go-name": "AutoRotate"
          },
          "delete_protection": {
            "description": "Protection from accidental deletion of this object [true/false]",
            "type": "string",
            "x-go-name": "ObjectProtected"
          },
          "description": {
            "description": "Description of the object",
            "type": "string",
            "x-go-name": "Description"
          },
          "enable-agentic-runtime-authority": {
            "description": "EnableAra is the documented spelling of AraEnabled. Both set the same\nfield; --ara-enabled shipped first and stays as an undocumented alias\nso existing scripts and the Terraform provider keep working.",
            "type": "boolean",
            "x-go-name": "EnableAra"
          },
          "enable-ai-quorum": {
            "description": "Turns on AI Quorum checks for this item.",
            "type": "boolean",
            "x-go-name": "EnableAiQuorum"
          },
          "input-rule": {
            "description": "Agentic input rule in name=...,rule=... format (e.g. name=rule1,rule=Sanitize input)",
            "items": {
              "type": "string"
            },
            "type": "array",
            "x-go-name": "InputRules"
          },
          "item-custom-fields": {
            "additionalProperties": {
              "type": "string"
            },
            "description": "Additional custom fields to associate with the item",
            "type": "object",
            "x-go-name": "ItemCustomFields"
          },
          "json": {
            "default": false,
            "description": "Set output format to JSON",
            "type": "boolean",
            "x-go-name": "Json"
          },
          "key": {
            "type": "string",
            "x-go-name": "ProtectionKey"
          },
          "lock-during-sra-session": {
            "description": "Lock this secret for read/update while an SRA session is active",
            "type": "string",
            "x-go-name": "LockDuringSraSession"
          },
          "lock-on-read": {
            "description": "Lock this secret after each successful value read",
            "type": "string",
            "x-go-name": "LockOnRead"
          },
          "lock-ttl": {
            "description": "Lock TTL in minutes",
            "type": "string",
            "x-go-name": "LockTTL"
          },
          "max-versions": {
            "description": "Set the maximum number of versions, limited by the account settings defaults.",
            "type": "string",
            "x-go-name": "MaxVersions"
          },
          "name": {
            "description": "Rotated secret name",
            "type": "string",
            "x-go-name": "SecretName"
          },
          "output-rule": {
            "description": "Agentic output rule in name=...,rule=... format (e.g. name=rule1,rule=Mask secrets)",
            "items": {
              "type": "string"
            },
            "type": "array",
            "x-go-name": "OutputRules"
          },
          "password-length": {
            "description": "The length of the password to be generated",
            "type": "string",
            "x-go-name": "PasswordLengthInput"
          },
          "rotate-after-disconnect": {
            "$ref": "#/components/schemas/StringOrBool"
          },
          "rotate-on-unlock": {
            "description": "Rotate this secret after it is unlocked",
            "type": "string",
            "x-go-name": "RotateOnUnlock"
          },
          "rotated-password": {
            "description": "rotated-username password (relevant only for rotator-type=password)",
            "type": "string",
            "x-go-name": "RotatedPassword"
          },
          "rotated-username": {
            "description": "username to be rotated, if selected use-self-creds at rotator-creds-type, this username will try to rotate it's own password, if use-target-creds is selected, target credentials will be use to rotate the rotated-password (relevant only for rotator-type=password)",
            "type": "string",
            "x-go-name": "RotatedUser"
          },
          "rotation-event-in": {
            "description": "How many days before the rotation of the item would you like to be notified",
            "items": {
              "type": "string"
            },
            "type": "array",
            "x-go-name": "RotationEventsInDays"
          },
          "rotation-hour": {
            "format": "int32",
            "type": "integer",
            "x-go-name": "RotationHour"
          },
          "rotation-interval": {
            "type": "string",
            "x-go-name": "RotationInterval"
          },
          "rotator-type": {
            "description": "The rotator type. options: [target/password]",
            "type": "string",
            "x-go-name": "RotatorType"
          },
          "secure-access-bastion-issuer": {
            "description": "Deprecated. use secure-access-certificate-issuer",
            "type": "string",
            "x-go-name": "SecureAccessBastionIssuer"
          },
          "secure-access-certificate-issuer": {
            "description": "Path to the SSH Certificate Issuer for your Akeyless Secure Access",
            "type": "string",
            "x-go-name": "SecureAccessCertIssuer"
          },
          "secure-access-db-name": {
            "description": "The DB name (relevant only for DB Dynamic-Secret)",
            "type": "string",
            "x-go-name": "SecureAccessDBName"
          },
          "secure-access-db-schema": {
            "description": "The DB schema",
            "type": "string",
            "x-go-name": "SecureAccessSchema"
          },
          "secure-access-enable": {
            "description": "Enable/Disable secure remote access [true/false]",
            "type": "string",
            "x-go-name": "SecureAccessEnabled"
          },
          "secure-access-host": {
            "description": "Target servers for connections (In case of Linked Target association, host(s) will inherit Linked Target hosts - Relevant only for Dynamic Secrets/producers)",
            "items": {
              "type": "string"
            },
            "type": "array",
            "x-go-name": "SecureAccessHost"
          },
          "secure-access-web": {
            "default": false,
            "description": "Enable Web Secure Remote Access",
            "type": "boolean",
            "x-go-name": "SecureAccessWebCategory"
          },
          "skip-dry-run": {
            "description": "If set, dry-run will be skipped [true/false]",
            "type": "boolean",
            "x-go-name": "SkipDryRun"
          },
          "tags": {
            "description": "Add tags attached to this object",
            "items": {
              "type": "string"
            },
            "type": "array",
            "x-go-name": "Tags"
          },
          "target-name": {
            "description": "The target name to associate",
            "type": "string",
            "x-go-name": "TargetName"
          },
          "token": {
            "description": "Authentication token (see `/auth` and `/configure`)",
            "type": "string",
            "x-go-name": "Profile"
          },
          "uid-token": {
            "description": "The universal identity token, Required only for universal_identity authentication",
            "type": "string",
            "x-go-name": "UIDToken"
          },
          "use-capital-letters": {
            "description": "Specifies whether the generated temporary password must contain at least one uppercase character from the ISO basic Latin alphabet (A to Z). [true/false]",
            "type": "string",
            "x-go-name": "UseCapitalLettersV2"
          },
          "use-lower-letters": {
            "description": "Specifies whether the generated temporary password must contain at least one lowercase character from the ISO basic Latin alphabet (a to z). [true/false]",
            "type": "string",
            "x-go-name": "UseLowerLetters"
          },
          "use-numbers": {
            "description": "Specifies whether the generated temporary password must contain at least one numeric character (0 to 9). [true/false]",
            "type": "string",
            "x-go-name": "UseNumbers"
          },
          "use-special-characters": {
            "example": "! @ # $. [true/false]",
            "type": "string",
            "x-go-name": "UseSpecialCharacters"
          }
        },
        "required": [
          "name",
          "rotator-type",
          "target-name"
        ],
        "title": "rotatedSecretCreatePostgresql is a command that creates a rotated secret.",
        "type": "object",
        "x-go-package": "akeyless.io/akeyless-main-repo/go/src/client/commands"
      }
    }
  }
}
```