AWS Secrets Manager
amazonaws · Cloud
Amazon Web Services Secrets Manager Amazon Web Services Secrets Manager provides a service to enable you to store, manage, and retrieve, secrets. This guide provides descriptions of the Secrets Manager API. For more information about using this service, see the Amazon Web Services Secrets Manager User Guide . API Version This version of the Secrets Mana
Authentication
Sample Requests
Lists the versions of a secret. Secrets Manager uses staging labels to indicate the different versions of a secret. For more information, see Secrets Manager concepts: Versions . To
Hover any highlighted part to learn what it does
| X-Amz-Target | secretsmanager.ListSecretVersionIds |
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.ListSecretVersionIds?NextToken=example&MaxResults=example" \ -H "X-Amz-Target: secretsmanager.ListSecretVersionIds"
import requests
params = {
"NextToken": "example",
"MaxResults": "example"
}
headers = {
"X-Amz-Target": "secretsmanager.ListSecretVersionIds"
}
response = requests.post(
"https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.ListSecretVersionIds",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.ListSecretVersionIds');
url.searchParams.set('NextToken', 'example');
url.searchParams.set('MaxResults', 'example');
const response = await fetch(url, {
method: 'POST',
headers: {
'X-Amz-Target': 'secretsmanager.ListSecretVersionIds'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.ListSecretVersionIds")
q := baseURL.Query()
q.Set("NextToken", "example")
q.Set("MaxResults", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("POST", targetURL, nil)
req.Header.Set("X-Amz-Target", "secretsmanager.ListSecretVersionIds")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.ListSecretVersionIds")
uri.query = URI.encode_www_form({
"NextToken" => "example",
"MaxResults" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Post.new(uri)
req["X-Amz-Target"] = "secretsmanager.ListSecretVersionIds"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.ListSecretVersionIds?" . http_build_query([
"NextToken" => "example",
"MaxResults" => "example"
]);
$opts = ["http" => [
"method" => "POST",
"header" => implode("\r\n", [
"X-Amz-Target: secretsmanager.ListSecretVersionIds"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Lists the secrets that are stored by Secrets Manager in the Amazon Web Services account, not including secrets that are marked for deletion. To see secrets marked for deletion, use the Secrets Manager console. ListSecrets is eventually consistent, however it might not reflect changes from
Hover any highlighted part to learn what it does
| X-Amz-Target | secretsmanager.ListSecrets |
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.ListSecrets?NextToken=example&MaxResults=example" \ -H "X-Amz-Target: secretsmanager.ListSecrets"
import requests
params = {
"NextToken": "example",
"MaxResults": "example"
}
headers = {
"X-Amz-Target": "secretsmanager.ListSecrets"
}
response = requests.post(
"https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.ListSecrets",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.ListSecrets');
url.searchParams.set('NextToken', 'example');
url.searchParams.set('MaxResults', 'example');
const response = await fetch(url, {
method: 'POST',
headers: {
'X-Amz-Target': 'secretsmanager.ListSecrets'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.ListSecrets")
q := baseURL.Query()
q.Set("NextToken", "example")
q.Set("MaxResults", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("POST", targetURL, nil)
req.Header.Set("X-Amz-Target", "secretsmanager.ListSecrets")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.ListSecrets")
uri.query = URI.encode_www_form({
"NextToken" => "example",
"MaxResults" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Post.new(uri)
req["X-Amz-Target"] = "secretsmanager.ListSecrets"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.ListSecrets?" . http_build_query([
"NextToken" => "example",
"MaxResults" => "example"
]);
$opts = ["http" => [
"method" => "POST",
"header" => implode("\r\n", [
"X-Amz-Target: secretsmanager.ListSecrets"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Turns off automatic rotation, and if a rotation is currently in progress, cancels the rotation. If you cancel a rotation in progress, it can leave the VersionStage labels in an unexpected state. You might need to remove the staging label AWSPENDING from the partia
Hover any highlighted part to learn what it does
| X-Amz-Target | secretsmanager.CancelRotateSecret |
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.CancelRotateSecret" \ -H "X-Amz-Target: secretsmanager.CancelRotateSecret"
import requests
headers = {
"X-Amz-Target": "secretsmanager.CancelRotateSecret"
}
response = requests.post(
"https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.CancelRotateSecret",
headers=headers,
)
print(response.json())const url = 'https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.CancelRotateSecret';
const response = await fetch(url, {
method: 'POST',
headers: {
'X-Amz-Target': 'secretsmanager.CancelRotateSecret'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
)
func main() {
targetURL := "https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.CancelRotateSecret"
req, _ := http.NewRequest("POST", targetURL, nil)
req.Header.Set("X-Amz-Target", "secretsmanager.CancelRotateSecret")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.CancelRotateSecret")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Post.new(uri)
req["X-Amz-Target"] = "secretsmanager.CancelRotateSecret"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/secretsmanager/2017-10-17/#X-Amz-Target=secretsmanager.CancelRotateSecret";
$opts = ["http" => [
"method" => "POST",
"header" => implode("\r\n", [
"X-Amz-Target: secretsmanager.CancelRotateSecret"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with AWS Secrets Manager?
AWS Secrets Manager is a Cloud API. Developers commonly use cloud APIs for:
- provisioning and managing cloud infrastructure
- automating deployments and container orchestration
- monitoring uptime and performance metrics
- managing storage buckets and databases
- setting up auto-scaling and load balancing
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. AWS Secrets Manager is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide · Learn about API keys · What is REST?