# 046 API Reference 7aa526f6

> AWS Secrets Manager API Reference

- Skill: `tools-only/046-api-reference-7aa526f6` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/046-api-reference-7aa526f6`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/046-api-reference-7aa526f6/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tools-only/046-api-reference-7aa526f6

---

# AWS Secrets Manager API Reference

## Overview
AWS Secrets Manager provides a service to enable you to store, manage, and retrieve secrets with API version 2017-10-17.

## Core Classes

### SecretsManagerClient
- **Purpose**: Synchronous client for AWS Secrets Manager
- **Location**: `software.amazon.awssdk.services.secretsmanager.SecretsManagerClient`
- **Builder**: `SecretsManagerClient.builder()`

### SecretsManagerAsyncClient
- **Purpose**: Asynchronous client for AWS Secrets Manager
- **Location**: `software.amazon.awssdk.services.secretsmanager.SecretsManagerAsyncClient`
- **Builder**: `SecretsManagerAsyncClient.builder()`

## Configuration Classes

### SecretsManagerClientBuilder
- Methods:
  - `region(Region region)` - Set AWS region
  - `credentialsProvider(AwsCredentialsProvider credentialsProvider)` - Set credentials
  - `build()` - Create client instance

### SecretsManagerServiceClientConfiguration
- Service client settings and configuration

## Request Types

### CreateSecretRequest
- **Fields**:
  - `name(String name)` - Secret name (required)
  - `secretString(String secretString)` - Secret value
  - `secretBinary(SdkBytes secretBinary)` - Binary secret value
  - `description(String description)` - Secret description
  - `kmsKeyId(String kmsKeyId)` - KMS key for encryption
  - `tags(List<Tag> tags)` - Tags for organization

### GetSecretValueRequest
- **Fields**:
  - `secretId(String secretId)` - Secret name or ARN
  - `versionId(String versionId)` - Specific version ID
  - `versionStage(String versionStage)` - Version stage (e.g., "AWSCURRENT")

### UpdateSecretRequest
- **Fields**:
  - `secretId(String secretId)` - Secret name or ARN
  - `secretString(String secretString)` - New secret value
  - `secretBinary(SdkBytes secretBinary)` - New binary secret value
  - `kmsKeyId(String kmsKeyId)` - KMS key for encryption

### DeleteSecretRequest
- **Fields**:
  - `secretId(String secretId)` - Secret name or ARN
  - `recoveryWindowInDays(Long recoveryWindowInDays)` - Recovery period
  - `forceDeleteWithoutRecovery(Boolean forceDeleteWithoutRecovery)` - Immediate deletion

### RotateSecretRequest
- **Fields**:
  - `secretId(String secretId)` - Secret name or ARN
  - `rotationLambdaArn(String rotationLambdaArn)` - Lambda ARN for rotation
  - `rotationRules(RotationRulesType rotationRules)` - Rotation configuration
  - `rotationSchedule(RotationScheduleType rotationSchedule)` - Schedule configuration

## Response Types

### CreateSecretResponse
- **Fields**:
  - `arn()` - Secret ARN
  - `name()` - Secret name
  - `versionId()` - Version ID

### GetSecretValueResponse
- **Fields**:
  - `arn()` - Secret ARN
  - `name()` - Secret name
  - `versionId()` - Version ID
  - `secretString()` - Secret value as string
  - `secretBinary()` - Secret value as binary
  - `versionStages()` - Version stages

### UpdateSecretResponse
- **Fields**:
  - `arn()` - Secret ARN
  - `name()` - Secret name
  - `versionId()` - New version ID

### DeleteSecretResponse
- **Fields**:
  - `arn()` - Secret ARN
  - `name()` - Secret name
  - `deletionDate()` - Deletion date/time

### RotateSecretResponse
- **Fields**:
  - `arn()` - Secret ARN
  - `name()` - Secret name
  - `versionId()` - New version ID

## Paginated Operations

### ListSecretsRequest
- **Fields**:
  - `maxResults(Integer maxResults)` - Maximum results per page
  - `nextToken(String nextToken)` - Token for next page
  - `filter(String filter)` - Filter criteria

### ListSecretsResponse
- **Fields**:
  - `secretList()` - List of secrets
  - `nextToken()` - Token for next page

## Error Handling

### SecretsManagerException
- Common error codes:
  - `ResourceNotFoundException` - Secret not found
  - `InvalidParameterException` - Invalid parameters
  - `MalformedPolicyDocumentException` - Invalid policy document
  - `InternalServiceErrorException` - Internal service error
  - `InvalidRequestException` - Invalid request
  - `DecryptionFailure` - Decryption failed
  - `ResourceExistsException` - Resource already exists
  - `ResourceConflictException` - Resource conflict
  - `ValidationException` - Validation failed