v1

latestOpenAPI 3.1.0proprietary2026-07-24156175241.3 KB
AWS Secrets Manager Secrets

Create Managed Secret

Create a new managed secret reference within an AWS Secrets Manager account.

post/v0/aws-secrets-manager/accounts/{account-id}/secrets

Path parameters

account-idinteger required

The ID of the AWS Secrets Manager account

Request body

namestring required

A descriptive label for this secret reference

secret_identifierstring required

The name or ARN of the secret in AWS Secrets Manager

regionstring required

The AWS region where the secret is stored

descriptionstring nullable

An optional description

secret_versionstring nullable

A specific version ID or stage label (omit to use the latest version)

version_kind'id' | 'stage'

Selects whether secret_version is treated as a VersionId or VersionStage for AWS GetSecretValue

Response

Created

idinteger

The unique identifier of the managed secret

namestring

The name of the managed secret

descriptionstring nullable

An optional description

account_idinteger

The account this secret belongs to

secret_identifierstring

The identifier used to fetch the secret from AWS Secrets Manager

secret_versionstring nullable
regionstring

The AWS region where the secret is stored

version_kind'id' | 'stage' nullable

Selects whether secret_version is treated as a VersionId or VersionStage for AWS GetSecretValue

created_atstring date-time
updated_atstring date-time