Amazon Secrets Manager

Amazon Secrets Manager helps you manage, retrieve, and rotate database credentials, API keys, and other secrets throughout their lifecycle. It provides centralized secrets management with built-in integration for Amazon RDS, Amazon Redshift, and Amazon DocumentDB, enabling automatic rotation of secrets without requiring application changes.

Amazon Secrets Manager publishes 5 APIs on the APIs.io network, including Passwords API, Rotation API, Secrets API, and 2 more. Tagged areas include Configuration, Credentials, Rotation, Secrets, and Security.

The Amazon Secrets Manager catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Amazon Secrets Manager’s developer surface includes authentication, CLI, developer portal, getting-started guide, documentation, API reference, developer console, and 57 more developer resources.

🌐 Visit website 📡 Source on GitHub

77.1/100 exemplar ▬ flat Agent 50/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemium

5 APIs 1 MCP Servers 8 Features 6 Use Cases

ConfigurationCredentialsRotationSecretsSecurity

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 77.1/100 · exemplar

Contract Quality 18.1 / 25

Developer Ergonomics 14.3 / 20

Commercial Clarity 17.4 / 20

Operational Transparency 8.2 / 13

Governance 9.6 / 12

Discoverability 9.4 / 10

Agent readiness — 50/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 4 / 4

Consent & Bot Identity 3 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/amazon-secrets-manager: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 5

Individual APIs this provider publishes, each with its own machine-readable definition.

Amazon Secrets Manager Passwords API

Operations for generating passwords.

Amazon Secrets Manager Rotation API

Operations for rotating secrets.

Amazon Secrets Manager Secrets API

Operations for managing secrets.

Amazon Secrets Manager #TagResource API

The #TagResource API from Amazon Secrets Manager — 1 operation(s) for #tagresource.

Amazon Secrets Manager #UntagResource API

The #UntagResource API from Amazon Secrets Manager — 1 operation(s) for #untagresource.

Postman Collections 1

Ready-to-run Postman collections for exercising this provider's APIs.

Amazon Secrets Manager API

POSTMAN

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Amazon Secrets Manager API

OPEN COLLECTION

Arazzo Workflows 8

Multi-step API workflows described with the Arazzo specification.

Amazon Secrets Manager Create and Read Secret

Create a new secret, then immediately retrieve its decrypted value to confirm it was stored.

ARAZZO

Amazon Secrets Manager Find and Delete Secret

List secrets filtered by name, branch on whether a match exists, then describe and schedule deletion of the matched secret.

ARAZZO

Amazon Secrets Manager Generate Password and Store Secret

Generate a random password, store it as a new secret, then read the secret value back to confirm it was saved.

ARAZZO

Amazon Secrets Manager Restore Deleted Secret

Cancel the scheduled deletion of a secret with RestoreSecret, then describe it to confirm the DeletedDate was cleared.

ARAZZO

Amazon Secrets Manager Rotate and Describe

Start rotation on a secret with a Lambda rotation function, then describe it to confirm rotation is configured.

ARAZZO

Amazon Secrets Manager Put New Version and Verify

Store a new encrypted version of a secret with PutSecretValue, then read the current value to confirm the update.

ARAZZO

Amazon Secrets Manager Tag Secret and Verify

Attach tags to a secret with TagResource, then describe the secret to confirm the tags are present in its metadata.

ARAZZO

Amazon Secrets Manager Update Metadata and Verify

Update a secret's description and KMS key with UpdateSecret, then describe it to confirm the new metadata was applied.

ARAZZO

Scroll for all 8

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

amazon-secrets-manager-mcp.yml

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Amazon Secrets Manager Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Amazon Secrets Manager Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Amazon Secrets Manager Finops

FINOPS

Features 8

Notable capabilities this provider offers.

Automatic Secret Rotation

Automatically rotate secrets on a schedule using AWS Lambda rotation functions without changing application code.

Centralized Secret Storage

Store and manage all secrets in a single, centralized location with fine-grained access controls.

Native Database Integration

Built-in integration with Amazon RDS, Aurora, Redshift, and DocumentDB for automatic credential rotation.

Secret Versioning

Maintain multiple versions of a secret simultaneously to support zero-downtime rotation.

Audit and Compliance

Log all secret access and management actions via AWS CloudTrail for compliance and audit purposes.

Cross-Account Access

Share secrets across AWS accounts using resource-based policies.

Encryption at Rest

All secrets are encrypted at rest using AWS KMS keys you control.

Random Password Generation

Generate cryptographically secure random passwords with configurable complexity requirements.

Scroll for all 8

JSON Schema 6

Standalone JSON Schema definitions for this provider's data models.

Examples 6

Example request and response payloads for these APIs.

Use Cases 6

What developers build with this provider.

Database Credential Management

Automatically rotate and manage database credentials for RDS, Aurora, and other databases.

API Key Storage

Securely store and retrieve API keys, OAuth tokens, and other third-party service credentials.

Application Configuration

Centralize sensitive application configuration such as connection strings and encryption keys.

Cross-Service Credentials

Share service-to-service credentials securely across microservices without embedding in code.

Compliance Secret Rotation

Meet compliance requirements like PCI DSS and SOC 2 by enforcing regular credential rotation.

Secrets Lifecycle Governance

Enforce organizational policies on secret creation, rotation schedules, and access patterns.

Resources

Get Started 4

Portal, sign-up, and the first successful call

Portal

GettingStarted

Console

Signup

Documentation 5

Reference material describing how the API behaves

Documentation

APIReference

JSONSchema

JSONSchema

JSONSchema

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

WellKnown

MCPServer

LLMsTxt

Design & Contract 22

Pagination, idempotency, versioning, errors, and events

Conformance

ErrorCatalog

Lifecycle

Conventions

DataModel

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

SpectralRules

Vocabulary

JSONLD

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

Scroll for all 22

Build 11

SDKs, sample code, and the tooling you integrate with

Packages

Packages

CLI

CLI

PostmanWorkspace

PostmanWorkspace

GitHubOrganization

CLI

Examples

Examples

Examples

Examples

Examples

Examples

Scroll for all 11

Access & Security 7

Authentication, authorization, and security posture

TrustCenter

TrustCenter

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

Authentication

SecurityTxt

Security

Compliance

Scroll for all 7

Learn 1

Tutorials, courses, talks, and written guidance

YouTube

YouTube

Operate 4

Status, limits, changes, and where to get help

FAQ

StatusPage

Support

StackOverflow

Commercial 3

Pricing, plans, and the legal terms of use

Pricing

Pricing

TermsOfService

TermsOfService

PrivacyPolicy

PrivacyPolicy

Company 1

The organization behind the API

Blog

Blog

Other 2

Properties that don't map to a standard resource type

Overlay

Overlay

KnowledgeCenter

KnowledgeCenter

Source (apis.yml)

accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/amazon-secrets-manager.png
name: Amazon Secrets Manager
description: Amazon Secrets Manager helps you manage, retrieve, and rotate database credentials, API keys, and other secrets
  throughout their lifecycle. It provides centralized secrets management with built-in integration for Amazon RDS, Amazon
  Redshift, and Amazon DocumentDB, enabling automatic rotation of secrets without requiring application changes.
url: https://aws.amazon.com/secrets-manager/
baseURL: https://secretsmanager.amazonaws.com
kind: company
created: '2024-01-01'
modified: '2026-06-20'
tags:
- AWS
- Configuration
- Credentials
- Rotation
- Secrets
- Security
apis:
- aid: amazon-secrets-manager:amazon-secrets-manager-passwords-api
  name: Amazon Secrets Manager Passwords API
  description: Operations for generating passwords.
  humanURL: https://docs.aws.amazon.com/secretsmanager/latest/apireference/
  baseURL: https://secretsmanager.{region}.amazonaws.com
  tags:
  - Passwords
  properties:
  - type: OpenAPI
    url: openapi/amazon-secrets-manager-passwords-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/secretsmanager/latest/apireference/
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-secret-schema.json
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-secret-value-schema.json
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-rotation-rules-schema.json
- aid: amazon-secrets-manager:amazon-secrets-manager-rotation-api
  name: Amazon Secrets Manager Rotation API
  description: Operations for rotating secrets.
  humanURL: https://docs.aws.amazon.com/secretsmanager/latest/apireference/
  baseURL: https://secretsmanager.{region}.amazonaws.com
  tags:
  - Rotation
  properties:
  - type: OpenAPI
    url: openapi/amazon-secrets-manager-rotation-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/secretsmanager/latest/apireference/
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-secret-schema.json
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-secret-value-schema.json
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-rotation-rules-schema.json
- aid: amazon-secrets-manager:amazon-secrets-manager-secrets-api
  name: Amazon Secrets Manager Secrets API
  description: Operations for managing secrets.
  humanURL: https://docs.aws.amazon.com/secretsmanager/latest/apireference/
  baseURL: https://secretsmanager.{region}.amazonaws.com
  tags:
  - Secrets
  properties:
  - type: OpenAPI
    url: openapi/amazon-secrets-manager-secrets-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/secretsmanager/latest/apireference/
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-secret-schema.json
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-secret-value-schema.json
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-rotation-rules-schema.json
- aid: amazon-secrets-manager:amazon-secrets-manager-tagresource-api
  name: 'Amazon Secrets Manager #TagResource API'
  description: 'The #TagResource API from Amazon Secrets Manager — 1 operation(s) for #tagresource.'
  humanURL: https://docs.aws.amazon.com/secretsmanager/latest/apireference/
  baseURL: https://secretsmanager.{region}.amazonaws.com
  tags:
  - '#TagResource'
  properties:
  - type: OpenAPI
    url: openapi/amazon-secrets-manager-tagresource-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/secretsmanager/latest/apireference/
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-secret-schema.json
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-secret-value-schema.json
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-rotation-rules-schema.json
- aid: amazon-secrets-manager:amazon-secrets-manager-untagresource-api
  name: 'Amazon Secrets Manager #UntagResource API'
  description: 'The #UntagResource API from Amazon Secrets Manager — 1 operation(s) for #untagresource.'
  humanURL: https://docs.aws.amazon.com/secretsmanager/latest/apireference/
  baseURL: https://secretsmanager.{region}.amazonaws.com
  tags:
  - '#UntagResource'
  properties:
  - type: OpenAPI
    url: openapi/amazon-secrets-manager-untagresource-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/secretsmanager/latest/apireference/
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-secret-schema.json
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-secret-value-schema.json
  - type: JSONSchema
    url: json-schema/amazon-secrets-manager-rotation-rules-schema.json
common:
- type: AgenticAccess
  url: agentic-access/amazon-secrets-manager-agentic-access.yml
- type: TrustCenter
  url: security/amazon-secrets-manager-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/amazon-secrets-manager-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/amazon-secrets-manager-domain-security.yml
- type: Authentication
  url: authentication/amazon-secrets-manager-authentication.yml
- type: Packages
  url: packages/amazon-secrets-manager-packages.yml
- type: WellKnown
  url: well-known/amazon-secrets-manager-well-known.yml
- type: SecurityTxt
  url: well-known/amazon-secrets-manager-security.txt
- type: MCPServer
  url: mcp/amazon-secrets-manager-mcp.yml
- type: LLMsTxt
  url: llms/amazon-secrets-manager-llms.txt
- type: Overlay
  url: overlays/amazon-secrets-manager-openapi-overlay.yaml
- type: Conformance
  url: conformance/amazon-secrets-manager-conformance.yml
- type: ErrorCatalog
  url: errors/amazon-secrets-manager-problem-types.yml
- type: Lifecycle
  url: lifecycle/amazon-secrets-manager-lifecycle.yml
- type: Conventions
  url: conventions/amazon-secrets-manager-conventions.yml
- type: CLI
  url: cli/amazon-secrets-manager-cli.yml
- type: DataModel
  url: data-model/amazon-secrets-manager-data-model.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/amazon-secrets-manager/overview
- type: Arazzo
  url: arazzo/amazon-secrets-manager-create-and-read-secret-workflow.yml
  name: Amazon Secrets Manager Create and Read Secret
- type: Arazzo
  url: arazzo/amazon-secrets-manager-find-and-delete-secret-workflow.yml
  name: Amazon Secrets Manager Find and Delete Secret
- type: Arazzo
  url: arazzo/amazon-secrets-manager-generate-password-and-store-secret-workflow.yml
  name: Amazon Secrets Manager Generate Password and Store Secret
- type: Arazzo
  url: arazzo/amazon-secrets-manager-restore-deleted-secret-workflow.yml
  name: Amazon Secrets Manager Restore Deleted Secret
- type: Arazzo
  url: arazzo/amazon-secrets-manager-rotate-and-describe-workflow.yml
  name: Amazon Secrets Manager Rotate and Describe
- type: Arazzo
  url: arazzo/amazon-secrets-manager-rotate-version-and-verify-workflow.yml
  name: Amazon Secrets Manager Put New Version and Verify
- type: Arazzo
  url: arazzo/amazon-secrets-manager-tag-secret-and-verify-workflow.yml
  name: Amazon Secrets Manager Tag Secret and Verify
- type: Arazzo
  url: arazzo/amazon-secrets-manager-update-metadata-and-verify-workflow.yml
  name: Amazon Secrets Manager Update Metadata and Verify
- type: Portal
  url: https://aws.amazon.com/
- type: GettingStarted
  url: https://aws.amazon.com/secrets-manager/getting-started/
- type: Documentation
  url: https://docs.aws.amazon.com/secretsmanager/latest/userguide/
- type: APIReference
  url: https://docs.aws.amazon.com/secretsmanager/latest/apireference/
- type: Console
  url: https://console.aws.amazon.com/secretsmanager/
- type: Signup
  url: https://portal.aws.amazon.com/billing/signup
- type: Pricing
  url: https://aws.amazon.com/secrets-manager/pricing/
- type: FAQ
  url: https://aws.amazon.com/secrets-manager/faqs/
- type: Blog
  url: https://aws.amazon.com/blogs/security/
- type: StatusPage
  url: https://health.aws.amazon.com/health/status
- type: Support
  url: https://aws.amazon.com/support/
- type: TermsOfService
  url: https://aws.amazon.com/service-terms/
- type: PrivacyPolicy
  url: https://aws.amazon.com/privacy/
- type: Security
  url: https://docs.aws.amazon.com/secretsmanager/latest/userguide/security.html
- type: Compliance
  url: https://aws.amazon.com/compliance/
- type: GitHubOrganization
  url: https://github.com/aws
- type: YouTube
  url: https://www.youtube.com/user/AmazonWebServices
- type: StackOverflow
  url: https://stackoverflow.com/questions/tagged/aws-secrets-manager
- type: KnowledgeCenter
  url: https://repost.aws/knowledge-center
- type: CLI
  url: https://docs.aws.amazon.com/cli/latest/reference/secretsmanager/
- type: SpectralRules
  url: rules/amazon-secrets-manager-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/amazon-secrets-manager-vocabulary.yaml
- type: Features
  data:
  - name: Automatic Secret Rotation
    description: Automatically rotate secrets on a schedule using AWS Lambda rotation functions without changing application
      code.
  - name: Centralized Secret Storage
    description: Store and manage all secrets in a single, centralized location with fine-grained access controls.
  - name: Native Database Integration
    description: Built-in integration with Amazon RDS, Aurora, Redshift, and DocumentDB for automatic credential rotation.
  - name: Secret Versioning
    description: Maintain multiple versions of a secret simultaneously to support zero-downtime rotation.
  - name: Audit and Compliance
    description: Log all secret access and management actions via AWS CloudTrail for compliance and audit purposes.
  - name: Cross-Account Access
    description: Share secrets across AWS accounts using resource-based policies.
  - name: Encryption at Rest
    description: All secrets are encrypted at rest using AWS KMS keys you control.
  - name: Random Password Generation
    description: Generate cryptographically secure random passwords with configurable complexity requirements.
- type: UseCases
  data:
  - name: Database Credential Management
    description: Automatically rotate and manage database credentials for RDS, Aurora, and other databases.
  - name: API Key Storage
    description: Securely store and retrieve API keys, OAuth tokens, and other third-party service credentials.
  - name: Application Configuration
    description: Centralize sensitive application configuration such as connection strings and encryption keys.
  - name: Cross-Service Credentials
    description: Share service-to-service credentials securely across microservices without embedding in code.
  - name: Compliance Secret Rotation
    description: Meet compliance requirements like PCI DSS and SOC 2 by enforcing regular credential rotation.
  - name: Secrets Lifecycle Governance
    description: Enforce organizational policies on secret creation, rotation schedules, and access patterns.
- type: Integrations
  data:
  - name: Amazon RDS
    description: Native integration for automatic rotation of RDS database credentials.
  - name: Amazon Aurora
    description: Built-in support for rotating Aurora database master user passwords.
  - name: Amazon Redshift
    description: Automatic rotation of Redshift cluster credentials.
  - name: Amazon DocumentDB
    description: Native rotation support for DocumentDB user credentials.
  - name: AWS Lambda
    description: Lambda-powered custom rotation functions for any secret type.
  - name: AWS CloudTrail
    description: Audit logging of all Secrets Manager API calls via CloudTrail.
  - name: AWS KMS
    description: Encryption of secrets at rest using customer-managed KMS keys.
  - name: AWS IAM
    description: Fine-grained access control for secrets using IAM policies and resource-based policies.
  - name: AWS CloudFormation
    description: Provision and manage secrets as part of CloudFormation stacks.
- type: JSONLD
  url: json-ld/amazon-secrets-manager-context.jsonld
- type: JSONSchema
  url: json-schema/amazon-secrets-manager-get-random-password-response-schema.json
- type: JSONSchema
  url: json-schema/amazon-secrets-manager-list-secrets-response-schema.json
- type: JSONSchema
  url: json-schema/amazon-secrets-manager-tag-schema.json
- type: JSONStructure
  url: json-structure/amazon-secrets-manager-get-random-password-response-structure.json
- type: JSONStructure
  url: json-structure/amazon-secrets-manager-list-secrets-response-structure.json
- type: JSONStructure
  url: json-structure/amazon-secrets-manager-rotation-rules-structure.json
- type: JSONStructure
  url: json-structure/amazon-secrets-manager-secret-structure.json
- type: JSONStructure
  url: json-structure/amazon-secrets-manager-secret-value-structure.json
- type: JSONStructure
  url: json-structure/amazon-secrets-manager-tag-structure.json
- type: Examples
  url: examples/amazon-secrets-manager-get-random-password-response-example.json
- type: Examples
  url: examples/amazon-secrets-manager-list-secrets-response-example.json
- type: Examples
  url: examples/amazon-secrets-manager-rotation-rules-example.json
- type: Examples
  url: examples/amazon-secrets-manager-secret-example.json
- type: Examples
  url: examples/amazon-secrets-manager-secret-value-example.json
- type: Examples
  url: examples/amazon-secrets-manager-tag-example.json
- type: Integrations
  url: https://aws.amazon.com/partners/
maintainer: Kin Lane
integrations:
- name: Partner Programs
- name: Resources
- name: Success Stories
- name: Work with an AWS Partner
- name: AWS Marketplace
- name: AWS Partner Central
- name: Partner Paths
- name: co-sell with AWS

Amazon Secrets Manager

APIs 5

Postman Collections 1

Open Collections 1

Arazzo Workflows 8

MCP Servers 1

Pricing Plans 1

Rate Limits 1

FinOps 1

Features 8

Automatic Secret Rotation

Centralized Secret Storage

Native Database Integration

Secret Versioning

Audit and Compliance

Cross-Account Access

Encryption at Rest

Random Password Generation

Semantic Vocabularies 1

Spectral Rules 2

JSON Schema 6

JSON Structure 6

Examples 6

Security Posture 4

Agentic Access 1

Use Cases 6

Database Credential Management

API Key Storage

Application Configuration

Cross-Service Credentials

Compliance Secret Rotation

Secrets Lifecycle Governance

Get Started 4

Documentation 5

Agent Surfaces 4

Design & Contract 22

Build 11

Access & Security 7

Learn 1

Operate 4

Commercial 3

Company 1

Other 2

Source (apis.yml)