Amazon Well-Architected Tool
The AWS Well-Architected Tool helps you review your workloads and compare them to the latest AWS architectural best practices. It provides a consistent process for evaluating architectures and implementing designs that scale over time across five pillars: operational excellence, security, reliability, performance efficiency, and cost optimization. The tool offers lens catalogs, custom lenses, profiles, review templates, and API-driven extensibility for integration into governance workflows.
Reference-quality API operations across every facet — a rich contract, published governance, transparent operations, and machine-readable commercial terms.
API Evangelist profiles Amazon Well-Architected Tool the way a machine reads it — 800 machine-readable artifacts across 13 APIs, pulled from the provider's own public surface and indexed so a developer, an analyst, or an AI agent can evaluate it against every other provider on the network.
Every provider in the network is reduced to the same set of machine-readable artifacts — OpenAPI contracts, event specifications, GraphQL schemas, runnable collections, pricing and rate-limit signals, security posture, OAuth scopes, and the agent surfaces (MCP servers and skills) that let software drive the API on its own. We profile them because the interface is the part of a company you can actually inspect: it is a truer signal of what a provider does than any marketing page. From those artifacts we compute the Kin Score — Amazon Well-Architected Tool scores 72.2/100 (exemplar), with a separate agent-readiness read of 48/100 (agent ready). The full breakdown is below, followed by every artifact we hold — each card links through to its machine-readable definition on apis.io.
Kin Score
This is the API Evangelist rating — a single, repeatable read computed from the artifacts on this page. Green fill is points earned; the red track is points possible, so every bar shows earned-versus-possible at a glance.
Kin Score
How this is scored →scored 2026-07-27 · rubric v0.5
How we profile Amazon Well-Architected Tool
Each block below is one kind of artifact we hold for Amazon Well-Architected Tool. For each we say what it is and why it earns a place in the profile, then list every one we've indexed — capped at two rows, scroll within the panel for the rest.
APIs 13
Each API is captured as its own OpenAPI definition — every operation, parameter, and response. This is the single most useful machine-readable description of what an API does, and it's what lets us score, lint, mock, and generate against it without asking the provider for anything.
Individual APIs this provider publishes, each with its own machine-readable definition.
Amazon Well-Architected Tool ConsolidatedReport#Format API
The ConsolidatedReport#Format API from Amazon Well-Architected Tool — 1 operation(s) for consolidatedreport#format.
Amazon Well-Architected Tool Global Settings API
The Global Settings API from Amazon Well-Architected Tool — 1 operation(s) for global settings.
Amazon Well-Architected Tool ImportLens API
The ImportLens API from Amazon Well-Architected Tool — 1 operation(s) for importlens.
Amazon Well-Architected Tool Lenses API
The Lenses API from Amazon Well-Architected Tool — 8 operation(s) for lenses.
Amazon Well-Architected Tool Notifications API
The Notifications API from Amazon Well-Architected Tool — 1 operation(s) for notifications.
Amazon Well-Architected Tool ProfileNotifications API
The ProfileNotifications API from Amazon Well-Architected Tool — 1 operation(s) for profilenotifications.
Amazon Well-Architected Tool Profiles API
The Profiles API from Amazon Well-Architected Tool — 5 operation(s) for profiles.
Amazon Well-Architected Tool ProfileSummaries API
The ProfileSummaries API from Amazon Well-Architected Tool — 1 operation(s) for profilesummaries.
Amazon Well-Architected Tool ProfileTemplate API
The ProfileTemplate API from Amazon Well-Architected Tool — 1 operation(s) for profiletemplate.
Amazon Well-Architected Tool ShareInvitations API
The ShareInvitations API from Amazon Well-Architected Tool — 2 operation(s) for shareinvitations.
Amazon Well-Architected Tool Tags API
The Tags API from Amazon Well-Architected Tool — 2 operation(s) for tags.
Amazon Well-Architected Tool Workloads API
The Workloads API from Amazon Well-Architected Tool — 23 operation(s) for workloads.
Amazon Well-Architected Tool WorkloadsSummaries API
The WorkloadsSummaries API from Amazon Well-Architected Tool — 1 operation(s) for workloadssummaries.
Scroll within the panel for all 13 ·
Postman Collections 1
A runnable collection turns the contract into something a developer can execute in seconds. We profile them because the fastest way to trust an API is to make a real call against it.
Ready-to-run Postman collections for exercising this provider's APIs.
AWS Well-Architected Tool
POSTMANArazzo Workflows 13
Real integrations are rarely a single call. Arazzo describes the multi-step sequences — auth, then create, then confirm — so both a human and an agent can follow the choreography, not just the endpoints.
Multi-step API workflows described with the Arazzo specification.
Amazon Well-Architected Tool Annotate Lens Review
Read a lens review and record lens-level and pillar-level notes on it.
ARAZZOAmazon Well-Architected Tool Answer then Milestone
Update a best-practice answer and snapshot the result as a milestone.
ARAZZOAmazon Well-Architected Tool Associate Lens to Workload
Create a workload, attach additional lenses, and list the lens reviews.
ARAZZOAmazon Well-Architected Tool Capture Milestone
Record a milestone for a workload and read it back to confirm.
ARAZZOAmazon Well-Architected Tool Consolidated Report
List your workloads and generate a consolidated report across them.
ARAZZOAmazon Well-Architected Tool Create Workload
Create a workload, confirm it, and list the lens reviews it generated.
ARAZZOAmazon Well-Architected Tool Improvement Plan
Open a lens review and list its prioritized improvement items.
ARAZZOAmazon Well-Architected Tool Lens Review Report
Find a lens review on a workload and generate its review report.
ARAZZOAmazon Well-Architected Tool List Milestone Snapshots
List a workload's milestones and read the most recent one in detail.
ARAZZOAmazon Well-Architected Tool Review and Update a Lens Answer
Open a lens review, list its answers, read one question, and update it.
ARAZZOAmazon Well-Architected Tool Share Custom Lens
Share a custom lens with a principal and list its lens shares.
ARAZZOAmazon Well-Architected Tool Share Workload
Create a workload, share it with an account, and list its shares.
ARAZZOAmazon Well-Architected Tool Update Workload Metadata
Read a workload and update its descriptive metadata and pillar priorities.
ARAZZOScroll within the panel for all 13 ·
Pricing Plans 1
Pricing is part of the interface. Machine-readable plans tell you what a tier costs and includes before you commit — one of the six things the Kin Score reads for commercial clarity.
Published pricing tiers and plan structures.
Rate Limits 1
Rate limits are the difference between a demo that works and a production integration that doesn't fall over. Publishing them is an operational-transparency signal — and a hard requirement for any agent that plans its own throughput.
Documented rate limits and quota policies.
Amazon Well Architected Tool Rate Limits
RATE LIMITSFinOps 1
Cost, billing, and metering signals let a buyer model the financial operations of an API before it's live. We profile them for the same reason we profile pricing: the money is part of the contract.
Cost, billing, and metering signals for API financial operations.
Features 10
The notable capabilities this provider advertises, captured as structured features so they can be searched and compared instead of read one landing page at a time.
Notable capabilities this provider offers.
Lens Catalog
Expert-authored review lenses from AWS covering diverse technology and industry-specific pillars, continuously refreshed with latest best practices.
Custom Lenses
Create organization-specific lenses that combine internal best practices with AWS guidance, shareable with up to 300 IAM users or across AWS Organizations.
Profiles
Pre-define business goals to auto-generate prioritized review questions tailored to your workload context.
Review Templates
Standardize answers across multiple workloads to ensure consistent architectural reviews at scale.
Enhanced Collaboration
Share workloads and custom lenses with IAM users or integrate with AWS Organizations for organization-wide access and visibility.
Service Integration
Native integration with AWS Trusted Advisor and AWS Service Catalog AppRegistry to reduce manual review effort.
API-Driven Extensibility
Robust APIs allow extending Well-Architected functionality into existing architecture governance processes, applications, and workflows.
Milestone Tracking
Save milestones, implement improvements, and measure progress over time with point-in-time snapshots of workload review state.
Compliance and Regulatory Support
Available in GovCloud (US) with FedRAMP compliance for organizations with stringent regulatory requirements.
Consolidated Reporting
Generate consolidated reports across workloads for governance and executive visibility into architectural risk posture.
Scroll within the panel for all 10 ·
Semantic Vocabularies 1
JSON-LD contexts give the data shared meaning across APIs. We profile them because semantics are what let a machine reconcile 'customer' here with 'customer' somewhere else.
JSON-LD contexts and semantic vocabularies used across these APIs.
Spectral Rules 2
Governance rulesets we run against this provider's specs — the automated checks behind parts of the score. Profiling them makes the quality bar explicit and re-runnable, not a matter of opinion.
JSON Schema 314
Standalone JSON Schema definitions describe the data models behind the API. We profile them so the shapes are validatable on their own — useful long after a single request is forgotten.
Standalone JSON Schema definitions for this provider's data models.
AccessDeniedException
JSON SCHEMAAccountSummary
JSON SCHEMAAdditionalResourceType
JSON SCHEMAAdditionalResourcesList
JSON SCHEMAAdditionalResources
JSON SCHEMAAnswerReason
JSON SCHEMAAnswer
JSON SCHEMAAnswerSummaries
JSON SCHEMAAnswerSummary
JSON SCHEMAApplicationArn
JSON SCHEMAAssociateLensesInput
JSON SCHEMAAssociateProfilesInput
JSON SCHEMAAwsAccountId
JSON SCHEMAAwsRegion
JSON SCHEMABase64String
JSON SCHEMABestPractice
JSON SCHEMABestPractices
JSON SCHEMACheckDescription
JSON SCHEMACheckDetail
JSON SCHEMACheckDetails
JSON SCHEMACheckFailureReason
JSON SCHEMACheckId
JSON SCHEMACheckName
JSON SCHEMACheckProvider
JSON SCHEMACheckStatusCount
JSON SCHEMACheckStatus
JSON SCHEMACheckSummaries
JSON SCHEMACheckSummary
JSON SCHEMAChoiceAnswer
JSON SCHEMAChoiceAnswerSummaries
JSON SCHEMAChoiceAnswerSummary
JSON SCHEMAChoiceAnswers
JSON SCHEMAChoiceContentDisplayText
JSON SCHEMAChoiceContent
JSON SCHEMAChoiceContentUrl
JSON SCHEMAChoiceDescription
JSON SCHEMAChoiceId
JSON SCHEMAChoiceImprovementPlan
JSON SCHEMAChoiceImprovementPlans
JSON SCHEMAChoiceNotes
JSON SCHEMAChoiceReason
JSON SCHEMAChoice
JSON SCHEMAChoiceStatus
JSON SCHEMAChoiceTitle
JSON SCHEMAChoiceUpdate
JSON SCHEMAChoiceUpdates
JSON SCHEMAChoices
JSON SCHEMAClientRequestToken
JSON SCHEMAConflictException
JSON SCHEMAConsolidatedReportMetric
JSON SCHEMAConsolidatedReportMetrics
JSON SCHEMACount
JSON SCHEMACreateLensShareInput
JSON SCHEMACreateLensShareOutput
JSON SCHEMACreateLensVersionInput
JSON SCHEMACreateLensVersionOutput
JSON SCHEMACreateMilestoneInput
JSON SCHEMACreateMilestoneOutput
JSON SCHEMACreateProfileInput
JSON SCHEMACreateProfileOutput
JSON SCHEMACreateProfileShareInput
JSON SCHEMACreateProfileShareOutput
JSON SCHEMACreateWorkloadInput
JSON SCHEMACreateWorkloadOutput
JSON SCHEMACreateWorkloadShareInput
JSON SCHEMACreateWorkloadShareOutput
JSON SCHEMADefinitionType
JSON SCHEMADeleteLensInput
JSON SCHEMADeleteLensShareInput
JSON SCHEMADeleteProfileInput
JSON SCHEMADeleteProfileShareInput
JSON SCHEMADeleteWorkloadInput
JSON SCHEMADeleteWorkloadShareInput
JSON SCHEMADifferenceStatus
JSON SCHEMADisassociateLensesInput
JSON SCHEMADisassociateProfilesInput
JSON SCHEMADiscoveryIntegrationStatus
JSON SCHEMADisplayText
JSON SCHEMAExportLensInput
JSON SCHEMAExportLensOutput
JSON SCHEMAFlaggedResources
JSON SCHEMAGetAnswerInput
JSON SCHEMAGetAnswerOutput
JSON SCHEMAGetConsolidatedReportInput
JSON SCHEMAGetConsolidatedReportMaxResults
JSON SCHEMAGetConsolidatedReportOutput
JSON SCHEMAGetLensInput
JSON SCHEMAGetLensOutput
JSON SCHEMAGetLensReviewInput
JSON SCHEMAGetLensReviewOutput
JSON SCHEMAGetLensReviewReportInput
JSON SCHEMAGetLensReviewReportOutput
JSON SCHEMAGetLensVersionDifferenceInput
JSON SCHEMAGetLensVersionDifferenceOutput
JSON SCHEMAGetMilestoneInput
JSON SCHEMAGetMilestoneOutput
JSON SCHEMAGetProfileInput
JSON SCHEMAGetProfileOutput
JSON SCHEMAGetProfileTemplateInput
JSON SCHEMAGetProfileTemplateOutput
JSON SCHEMAGetWorkloadInput
JSON SCHEMAGetWorkloadOutput
JSON SCHEMAHelpfulResourceUrl
JSON SCHEMAImportLensInput
JSON SCHEMAImportLensOutput
JSON SCHEMAImportLensStatus
JSON SCHEMAImprovementPlanUrl
JSON SCHEMAImprovementSummaries
JSON SCHEMAImprovementSummary
JSON SCHEMAIncludeSharedResources
JSON SCHEMAInternalServerException
JSON SCHEMAIsApplicable
JSON SCHEMAIsMajorVersion
JSON SCHEMAIsReviewOwnerUpdateAcknowledged
JSON SCHEMALensAlias
JSON SCHEMALensAliases
JSON SCHEMALensArn
JSON SCHEMALensDescription
JSON SCHEMALensJSON
JSON SCHEMALensMetric
JSON SCHEMALensMetrics
JSON SCHEMALensNamePrefix
JSON SCHEMALensName
JSON SCHEMALensOwner
JSON SCHEMALensReviewReport
JSON SCHEMALensReview
JSON SCHEMALensReviewSummaries
JSON SCHEMALensReviewSummary
JSON SCHEMALens
JSON SCHEMALensShareSummaries
JSON SCHEMALensShareSummary
JSON SCHEMALensStatus
JSON SCHEMALensStatusType
JSON SCHEMALensSummaries
JSON SCHEMALensSummary
JSON SCHEMALensType
JSON SCHEMALensUpgradeSummary
JSON SCHEMALensVersion
JSON SCHEMALensesAppliedCount
JSON SCHEMAListAnswersInput
JSON SCHEMAListAnswersMaxResults
JSON SCHEMAListAnswersOutput
JSON SCHEMAListCheckDetailsInput
JSON SCHEMAListCheckDetailsOutput
JSON SCHEMAListCheckSummariesInput
JSON SCHEMAListCheckSummariesOutput
JSON SCHEMAListLensReviewImprovementsInput
JSON SCHEMAListLensReviewImprovementsMaxResults
JSON SCHEMAListLensReviewImprovementsOutput
JSON SCHEMAListLensReviewsInput
JSON SCHEMAListLensReviewsOutput
JSON SCHEMAListLensSharesInput
JSON SCHEMAListLensSharesOutput
JSON SCHEMAListLensesInput
JSON SCHEMAListLensesOutput
JSON SCHEMAListMilestonesInput
JSON SCHEMAListMilestonesOutput
JSON SCHEMAListNotificationsInput
JSON SCHEMAListNotificationsMaxResults
JSON SCHEMAListNotificationsOutput
JSON SCHEMAListProfileNotificationsInput
JSON SCHEMAListProfileNotificationsOutput
JSON SCHEMAListProfileSharesInput
JSON SCHEMAListProfileSharesMaxResults
JSON SCHEMAListProfileSharesOutput
JSON SCHEMAListProfilesInput
JSON SCHEMAListProfilesOutput
JSON SCHEMAListShareInvitationsInput
JSON SCHEMAListShareInvitationsMaxResults
JSON SCHEMAListShareInvitationsOutput
JSON SCHEMAListTagsForResourceInput
JSON SCHEMAListTagsForResourceOutput
JSON SCHEMAListWorkloadSharesInput
JSON SCHEMAListWorkloadSharesMaxResults
JSON SCHEMAListWorkloadSharesOutput
JSON SCHEMAListWorkloadsInput
JSON SCHEMAListWorkloadsMaxResults
JSON SCHEMAListWorkloadsOutput
JSON SCHEMAMaxResults
JSON SCHEMAMaxSelectedProfileChoices
JSON SCHEMAMetricType
JSON SCHEMAMilestoneName
JSON SCHEMAMilestoneNumber
JSON SCHEMAMilestone
JSON SCHEMAMilestoneSummaries
JSON SCHEMAMilestoneSummary
JSON SCHEMAMinSelectedProfileChoices
JSON SCHEMANextToken
JSON SCHEMANotes
JSON SCHEMANotificationSummaries
JSON SCHEMANotificationSummary
JSON SCHEMANotificationType
JSON SCHEMAOrganizationSharingStatus
JSON SCHEMAPermissionType
JSON SCHEMAPillarDifference
JSON SCHEMAPillarDifferences
JSON SCHEMAPillarId
JSON SCHEMAPillarMetric
JSON SCHEMAPillarMetrics
JSON SCHEMAPillarName
JSON SCHEMAPillarNotes
JSON SCHEMAPillarReviewSummaries
JSON SCHEMAPillarReviewSummary
JSON SCHEMAProfileArn
JSON SCHEMAProfileArns
JSON SCHEMAProfileChoice
JSON SCHEMAProfileDescription
JSON SCHEMAProfileNamePrefix
JSON SCHEMAProfileName
JSON SCHEMAProfileNotificationSummaries
JSON SCHEMAProfileNotificationSummary
JSON SCHEMAProfileNotificationType
JSON SCHEMAProfileOwnerType
JSON SCHEMAProfileQuestionChoices
JSON SCHEMAProfileQuestion
JSON SCHEMAProfileQuestionUpdate
JSON SCHEMAProfileQuestionUpdates
JSON SCHEMAProfileQuestions
JSON SCHEMAProfile
JSON SCHEMAProfileShareSummaries
JSON SCHEMAProfileShareSummary
JSON SCHEMAProfileSummaries
JSON SCHEMAProfileSummary
JSON SCHEMAProfileTemplateChoice
JSON SCHEMAProfileTemplateQuestionChoices
JSON SCHEMAProfileTemplateQuestion
JSON SCHEMAProfileTemplate
JSON SCHEMAProfileVersion
JSON SCHEMAQuestionDescription
JSON SCHEMAQuestionDifference
JSON SCHEMAQuestionDifferences
JSON SCHEMAQuestionId
JSON SCHEMAQuestionMetric
JSON SCHEMAQuestionMetrics
JSON SCHEMAQuestionPriority
JSON SCHEMAQuestionTitle
JSON SCHEMAQuestionType
JSON SCHEMAReportFormat
JSON SCHEMAResourceNotFoundException
JSON SCHEMARiskCounts
JSON SCHEMARisk
JSON SCHEMASelectedChoiceIds
JSON SCHEMASelectedChoices
JSON SCHEMASelectedProfileChoiceIds
JSON SCHEMAServiceQuotaExceededException
JSON SCHEMAShareId
JSON SCHEMAShareInvitationAction
JSON SCHEMAShareInvitationId
JSON SCHEMAShareInvitation
JSON SCHEMAShareInvitationSummaries
JSON SCHEMAShareInvitationSummary
JSON SCHEMAShareResourceType
JSON SCHEMAShareStatus
JSON SCHEMASharedWithPrefix
JSON SCHEMASharedWith
JSON SCHEMAStatusMessage
JSON SCHEMATagKeyList
JSON SCHEMATagKey
JSON SCHEMATagMap
JSON SCHEMATagResourceInput
JSON SCHEMATagResourceOutput
JSON SCHEMATagValue
JSON SCHEMATemplateQuestions
JSON SCHEMAThrottlingException
JSON SCHEMATimestamp
JSON SCHEMATrustedAdvisorIntegrationStatus
JSON SCHEMAUntagResourceInput
JSON SCHEMAUntagResourceOutput
JSON SCHEMAUpdateAnswerInput
JSON SCHEMAUpdateAnswerOutput
JSON SCHEMAUpdateGlobalSettingsInput
JSON SCHEMAUpdateLensReviewInput
JSON SCHEMAUpdateLensReviewOutput
JSON SCHEMAUpdateProfileInput
JSON SCHEMAUpdateProfileOutput
JSON SCHEMAUpdateShareInvitationInput
JSON SCHEMAUpdateShareInvitationOutput
JSON SCHEMAUpdateWorkloadInput
JSON SCHEMAUpdateWorkloadOutput
JSON SCHEMAUpdateWorkloadShareInput
JSON SCHEMAUpdateWorkloadShareOutput
JSON SCHEMAUpgradeLensReviewInput
JSON SCHEMAUpgradeProfileVersionInput
JSON SCHEMAUrls
JSON SCHEMAVersionDifferences
JSON SCHEMAWorkloadAccountIds
JSON SCHEMAWorkloadApplications
JSON SCHEMAWorkloadArchitecturalDesign
JSON SCHEMAWorkloadArn
JSON SCHEMAWorkloadAwsRegions
JSON SCHEMAWorkloadDescription
JSON SCHEMAWorkloadDiscoveryConfig
JSON SCHEMAWorkloadEnvironment
JSON SCHEMAWorkloadId
JSON SCHEMAWorkloadImprovementStatus
JSON SCHEMAWorkloadIndustry
JSON SCHEMAWorkloadIndustryType
JSON SCHEMAWorkloadLenses
JSON SCHEMAWorkloadNamePrefix
JSON SCHEMAWorkloadName
JSON SCHEMAWorkloadNonAwsRegion
JSON SCHEMAWorkloadNonAwsRegions
JSON SCHEMAWorkloadPillarPriorities
JSON SCHEMAWorkloadProfileArns
JSON SCHEMAWorkloadProfile
JSON SCHEMAWorkloadProfiles
JSON SCHEMAWorkloadResourceDefinition
JSON SCHEMAWorkloadReviewOwner
JSON SCHEMAWorkload
JSON SCHEMAWorkloadShare
JSON SCHEMAWorkloadShareSummaries
JSON SCHEMAWorkloadShareSummary
JSON SCHEMAWorkloadSummaries
JSON SCHEMAWorkloadSummary
JSON SCHEMAScroll within the panel for all 314 ·
JSON Structure 314
JSON Structure captures the data shapes in a form built for tooling — a complement to JSON Schema that keeps the model machine-legible.
JSON Structure definitions describing this provider's data shapes.
Well Architected Tool Access Denied Exception Structure
JSON STRUCTUREWell Architected Tool Account Summary Structure
JSON STRUCTUREWell Architected Tool Additional Resource Type Structure
JSON STRUCTUREWell Architected Tool Additional Resources Structure
JSON STRUCTUREWell Architected Tool Answer Reason Structure
JSON STRUCTUREWell Architected Tool Answer Structure
JSON STRUCTUREWell Architected Tool Answer Summaries Structure
JSON STRUCTUREWell Architected Tool Answer Summary Structure
JSON STRUCTUREWell Architected Tool Application Arn Structure
JSON STRUCTUREWell Architected Tool Associate Lenses Input Structure
JSON STRUCTUREWell Architected Tool Associate Profiles Input Structure
JSON STRUCTUREWell Architected Tool Aws Account Id Structure
JSON STRUCTUREWell Architected Tool Aws Region Structure
JSON STRUCTUREWell Architected Tool Base64 String Structure
JSON STRUCTUREWell Architected Tool Best Practice Structure
JSON STRUCTUREWell Architected Tool Best Practices Structure
JSON STRUCTUREWell Architected Tool Check Description Structure
JSON STRUCTUREWell Architected Tool Check Detail Structure
JSON STRUCTUREWell Architected Tool Check Details Structure
JSON STRUCTUREWell Architected Tool Check Failure Reason Structure
JSON STRUCTUREWell Architected Tool Check Id Structure
JSON STRUCTUREWell Architected Tool Check Name Structure
JSON STRUCTUREWell Architected Tool Check Provider Structure
JSON STRUCTUREWell Architected Tool Check Status Count Structure
JSON STRUCTUREWell Architected Tool Check Status Structure
JSON STRUCTUREWell Architected Tool Check Summaries Structure
JSON STRUCTUREWell Architected Tool Check Summary Structure
JSON STRUCTUREWell Architected Tool Choice Answer Structure
JSON STRUCTUREWell Architected Tool Choice Answer Summaries Structure
JSON STRUCTUREWell Architected Tool Choice Answer Summary Structure
JSON STRUCTUREWell Architected Tool Choice Answers Structure
JSON STRUCTUREWell Architected Tool Choice Content Structure
JSON STRUCTUREWell Architected Tool Choice Content Url Structure
JSON STRUCTUREWell Architected Tool Choice Description Structure
JSON STRUCTUREWell Architected Tool Choice Id Structure
JSON STRUCTUREWell Architected Tool Choice Improvement Plan Structure
JSON STRUCTUREWell Architected Tool Choice Improvement Plans Structure
JSON STRUCTUREWell Architected Tool Choice Notes Structure
JSON STRUCTUREWell Architected Tool Choice Reason Structure
JSON STRUCTUREWell Architected Tool Choice Status Structure
JSON STRUCTUREWell Architected Tool Choice Structure
JSON STRUCTUREWell Architected Tool Choice Title Structure
JSON STRUCTUREWell Architected Tool Choice Update Structure
JSON STRUCTUREWell Architected Tool Choice Updates Structure
JSON STRUCTUREWell Architected Tool Choices Structure
JSON STRUCTUREWell Architected Tool Client Request Token Structure
JSON STRUCTUREWell Architected Tool Conflict Exception Structure
JSON STRUCTUREWell Architected Tool Count Structure
JSON STRUCTUREWell Architected Tool Create Lens Share Input Structure
JSON STRUCTUREWell Architected Tool Create Lens Share Output Structure
JSON STRUCTUREWell Architected Tool Create Milestone Input Structure
JSON STRUCTUREWell Architected Tool Create Milestone Output Structure
JSON STRUCTUREWell Architected Tool Create Profile Input Structure
JSON STRUCTUREWell Architected Tool Create Profile Output Structure
JSON STRUCTUREWell Architected Tool Create Workload Input Structure
JSON STRUCTUREWell Architected Tool Create Workload Output Structure
JSON STRUCTUREWell Architected Tool Definition Type Structure
JSON STRUCTUREWell Architected Tool Delete Lens Input Structure
JSON STRUCTUREWell Architected Tool Delete Lens Share Input Structure
JSON STRUCTUREWell Architected Tool Delete Profile Input Structure
JSON STRUCTUREWell Architected Tool Delete Workload Input Structure
JSON STRUCTUREWell Architected Tool Difference Status Structure
JSON STRUCTUREWell Architected Tool Display Text Structure
JSON STRUCTUREWell Architected Tool Export Lens Input Structure
JSON STRUCTUREWell Architected Tool Export Lens Output Structure
JSON STRUCTUREWell Architected Tool Flagged Resources Structure
JSON STRUCTUREWell Architected Tool Get Answer Input Structure
JSON STRUCTUREWell Architected Tool Get Answer Output Structure
JSON STRUCTUREWell Architected Tool Get Lens Input Structure
JSON STRUCTUREWell Architected Tool Get Lens Output Structure
JSON STRUCTUREWell Architected Tool Get Lens Review Input Structure
JSON STRUCTUREWell Architected Tool Get Lens Review Output Structure
JSON STRUCTUREWell Architected Tool Get Milestone Input Structure
JSON STRUCTUREWell Architected Tool Get Milestone Output Structure
JSON STRUCTUREWell Architected Tool Get Profile Input Structure
JSON STRUCTUREWell Architected Tool Get Profile Output Structure
JSON STRUCTUREWell Architected Tool Get Workload Input Structure
JSON STRUCTUREWell Architected Tool Get Workload Output Structure
JSON STRUCTUREWell Architected Tool Helpful Resource Url Structure
JSON STRUCTUREWell Architected Tool Import Lens Input Structure
JSON STRUCTUREWell Architected Tool Import Lens Output Structure
JSON STRUCTUREWell Architected Tool Import Lens Status Structure
JSON STRUCTUREWell Architected Tool Improvement Plan Url Structure
JSON STRUCTUREWell Architected Tool Improvement Summaries Structure
JSON STRUCTUREWell Architected Tool Improvement Summary Structure
JSON STRUCTUREWell Architected Tool Include Shared Resources Structure
JSON STRUCTUREWell Architected Tool Is Applicable Structure
JSON STRUCTUREWell Architected Tool Is Major Version Structure
JSON STRUCTUREWell Architected Tool Lens Alias Structure
JSON STRUCTUREWell Architected Tool Lens Aliases Structure
JSON STRUCTUREWell Architected Tool Lens Arn Structure
JSON STRUCTUREWell Architected Tool Lens Description Structure
JSON STRUCTUREWell Architected Tool Lens Json Structure
JSON STRUCTUREWell Architected Tool Lens Metric Structure
JSON STRUCTUREWell Architected Tool Lens Metrics Structure
JSON STRUCTUREWell Architected Tool Lens Name Prefix Structure
JSON STRUCTUREWell Architected Tool Lens Name Structure
JSON STRUCTUREWell Architected Tool Lens Owner Structure
JSON STRUCTUREWell Architected Tool Lens Review Report Structure
JSON STRUCTUREWell Architected Tool Lens Review Structure
JSON STRUCTUREWell Architected Tool Lens Review Summaries Structure
JSON STRUCTUREWell Architected Tool Lens Review Summary Structure
JSON STRUCTUREWell Architected Tool Lens Share Summaries Structure
JSON STRUCTUREWell Architected Tool Lens Share Summary Structure
JSON STRUCTUREWell Architected Tool Lens Status Structure
JSON STRUCTUREWell Architected Tool Lens Status Type Structure
JSON STRUCTUREWell Architected Tool Lens Structure
JSON STRUCTUREWell Architected Tool Lens Summaries Structure
JSON STRUCTUREWell Architected Tool Lens Summary Structure
JSON STRUCTUREWell Architected Tool Lens Type Structure
JSON STRUCTUREWell Architected Tool Lens Upgrade Summary Structure
JSON STRUCTUREWell Architected Tool Lens Version Structure
JSON STRUCTUREWell Architected Tool Lenses Applied Count Structure
JSON STRUCTUREWell Architected Tool List Answers Input Structure
JSON STRUCTUREWell Architected Tool List Answers Max Results Structure
JSON STRUCTUREWell Architected Tool List Answers Output Structure
JSON STRUCTUREWell Architected Tool List Check Details Input Structure
JSON STRUCTUREWell Architected Tool List Lens Reviews Input Structure
JSON STRUCTUREWell Architected Tool List Lens Reviews Output Structure
JSON STRUCTUREWell Architected Tool List Lens Shares Input Structure
JSON STRUCTUREWell Architected Tool List Lens Shares Output Structure
JSON STRUCTUREWell Architected Tool List Lenses Input Structure
JSON STRUCTUREWell Architected Tool List Lenses Output Structure
JSON STRUCTUREWell Architected Tool List Milestones Input Structure
JSON STRUCTUREWell Architected Tool List Milestones Output Structure
JSON STRUCTUREWell Architected Tool List Notifications Input Structure
JSON STRUCTUREWell Architected Tool List Profiles Input Structure
JSON STRUCTUREWell Architected Tool List Profiles Output Structure
JSON STRUCTUREWell Architected Tool List Workloads Input Structure
JSON STRUCTUREWell Architected Tool List Workloads Output Structure
JSON STRUCTUREWell Architected Tool Max Results Structure
JSON STRUCTUREWell Architected Tool Metric Type Structure
JSON STRUCTUREWell Architected Tool Milestone Name Structure
JSON STRUCTUREWell Architected Tool Milestone Number Structure
JSON STRUCTUREWell Architected Tool Milestone Structure
JSON STRUCTUREWell Architected Tool Milestone Summaries Structure
JSON STRUCTUREWell Architected Tool Milestone Summary Structure
JSON STRUCTUREWell Architected Tool Next Token Structure
JSON STRUCTUREWell Architected Tool Notes Structure
JSON STRUCTUREWell Architected Tool Notification Summaries Structure
JSON STRUCTUREWell Architected Tool Notification Summary Structure
JSON STRUCTUREWell Architected Tool Notification Type Structure
JSON STRUCTUREWell Architected Tool Permission Type Structure
JSON STRUCTUREWell Architected Tool Pillar Difference Structure
JSON STRUCTUREWell Architected Tool Pillar Differences Structure
JSON STRUCTUREWell Architected Tool Pillar Id Structure
JSON STRUCTUREWell Architected Tool Pillar Metric Structure
JSON STRUCTUREWell Architected Tool Pillar Metrics Structure
JSON STRUCTUREWell Architected Tool Pillar Name Structure
JSON STRUCTUREWell Architected Tool Pillar Notes Structure
JSON STRUCTUREWell Architected Tool Pillar Review Summaries Structure
JSON STRUCTUREWell Architected Tool Pillar Review Summary Structure
JSON STRUCTUREWell Architected Tool Profile Arn Structure
JSON STRUCTUREWell Architected Tool Profile Arns Structure
JSON STRUCTUREWell Architected Tool Profile Choice Structure
JSON STRUCTUREWell Architected Tool Profile Description Structure
JSON STRUCTUREWell Architected Tool Profile Name Prefix Structure
JSON STRUCTUREWell Architected Tool Profile Name Structure
JSON STRUCTUREWell Architected Tool Profile Owner Type Structure
JSON STRUCTUREWell Architected Tool Profile Question Choices Structure
JSON STRUCTUREWell Architected Tool Profile Question Structure
JSON STRUCTUREWell Architected Tool Profile Question Update Structure
JSON STRUCTUREWell Architected Tool Profile Question Updates Structure
JSON STRUCTUREWell Architected Tool Profile Questions Structure
JSON STRUCTUREWell Architected Tool Profile Share Summaries Structure
JSON STRUCTUREWell Architected Tool Profile Share Summary Structure
JSON STRUCTUREWell Architected Tool Profile Structure
JSON STRUCTUREWell Architected Tool Profile Summaries Structure
JSON STRUCTUREWell Architected Tool Profile Summary Structure
JSON STRUCTUREWell Architected Tool Profile Template Choice Structure
JSON STRUCTUREWell Architected Tool Profile Template Structure
JSON STRUCTUREWell Architected Tool Profile Version Structure
JSON STRUCTUREWell Architected Tool Question Description Structure
JSON STRUCTUREWell Architected Tool Question Difference Structure
JSON STRUCTUREWell Architected Tool Question Differences Structure
JSON STRUCTUREWell Architected Tool Question Id Structure
JSON STRUCTUREWell Architected Tool Question Metric Structure
JSON STRUCTUREWell Architected Tool Question Metrics Structure
JSON STRUCTUREWell Architected Tool Question Priority Structure
JSON STRUCTUREWell Architected Tool Question Title Structure
JSON STRUCTUREWell Architected Tool Question Type Structure
JSON STRUCTUREWell Architected Tool Report Format Structure
JSON STRUCTUREWell Architected Tool Risk Counts Structure
JSON STRUCTUREWell Architected Tool Risk Structure
JSON STRUCTUREWell Architected Tool Selected Choice Ids Structure
JSON STRUCTUREWell Architected Tool Selected Choices Structure
JSON STRUCTUREWell Architected Tool Share Id Structure
JSON STRUCTUREWell Architected Tool Share Invitation Action Structure
JSON STRUCTUREWell Architected Tool Share Invitation Id Structure
JSON STRUCTUREWell Architected Tool Share Invitation Structure
JSON STRUCTUREWell Architected Tool Share Invitation Summary Structure
JSON STRUCTUREWell Architected Tool Share Resource Type Structure
JSON STRUCTUREWell Architected Tool Share Status Structure
JSON STRUCTUREWell Architected Tool Shared With Prefix Structure
JSON STRUCTUREWell Architected Tool Shared With Structure
JSON STRUCTUREWell Architected Tool Status Message Structure
JSON STRUCTUREWell Architected Tool Tag Key List Structure
JSON STRUCTUREWell Architected Tool Tag Key Structure
JSON STRUCTUREWell Architected Tool Tag Map Structure
JSON STRUCTUREWell Architected Tool Tag Resource Input Structure
JSON STRUCTUREWell Architected Tool Tag Resource Output Structure
JSON STRUCTUREWell Architected Tool Tag Value Structure
JSON STRUCTUREWell Architected Tool Template Questions Structure
JSON STRUCTUREWell Architected Tool Throttling Exception Structure
JSON STRUCTUREWell Architected Tool Timestamp Structure
JSON STRUCTUREWell Architected Tool Untag Resource Input Structure
JSON STRUCTUREWell Architected Tool Untag Resource Output Structure
JSON STRUCTUREWell Architected Tool Update Answer Input Structure
JSON STRUCTUREWell Architected Tool Update Answer Output Structure
JSON STRUCTUREWell Architected Tool Update Lens Review Input Structure
JSON STRUCTUREWell Architected Tool Update Profile Input Structure
JSON STRUCTUREWell Architected Tool Update Profile Output Structure
JSON STRUCTUREWell Architected Tool Update Workload Input Structure
JSON STRUCTUREWell Architected Tool Update Workload Output Structure
JSON STRUCTUREWell Architected Tool Urls Structure
JSON STRUCTUREWell Architected Tool Version Differences Structure
JSON STRUCTUREWell Architected Tool Workload Account Ids Structure
JSON STRUCTUREWell Architected Tool Workload Applications Structure
JSON STRUCTUREWell Architected Tool Workload Arn Structure
JSON STRUCTUREWell Architected Tool Workload Aws Regions Structure
JSON STRUCTUREWell Architected Tool Workload Description Structure
JSON STRUCTUREWell Architected Tool Workload Environment Structure
JSON STRUCTUREWell Architected Tool Workload Id Structure
JSON STRUCTUREWell Architected Tool Workload Industry Structure
JSON STRUCTUREWell Architected Tool Workload Industry Type Structure
JSON STRUCTUREWell Architected Tool Workload Lenses Structure
JSON STRUCTUREWell Architected Tool Workload Name Prefix Structure
JSON STRUCTUREWell Architected Tool Workload Name Structure
JSON STRUCTUREWell Architected Tool Workload Non Aws Region Structure
JSON STRUCTUREWell Architected Tool Workload Non Aws Regions Structure
JSON STRUCTUREWell Architected Tool Workload Profile Arns Structure
JSON STRUCTUREWell Architected Tool Workload Profile Structure
JSON STRUCTUREWell Architected Tool Workload Profiles Structure
JSON STRUCTUREWell Architected Tool Workload Review Owner Structure
JSON STRUCTUREWell Architected Tool Workload Share Structure
JSON STRUCTUREWell Architected Tool Workload Share Summaries Structure
JSON STRUCTUREWell Architected Tool Workload Share Summary Structure
JSON STRUCTUREWell Architected Tool Workload Structure
JSON STRUCTUREWell Architected Tool Workload Summaries Structure
JSON STRUCTUREWell Architected Tool Workload Summary Structure
JSON STRUCTUREScroll within the panel for all 314 ·
Examples 117
Real request and response payloads are what turn a spec from abstract into obvious — and they're one of the twelve things an agent needs to call an API correctly on the first try.
Example request and response payloads for these APIs.
Scroll within the panel for all 117 ·
Security Posture 4
Authentication, domain security, vulnerability disclosure, and trust-center signals — the evidence that a provider takes security seriously enough to document it. We profile it because you can't govern what you can't see.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Agentic Access 1
An x-agentic-access contract marks which operations are safe for an agent to run on its own and which need a human in the loop. It is the difference between an API an agent can use and one it can use safely.
Recommended x-agentic-access execution contracts for AI agents.
Use Cases 7
What developers actually build with this provider — captured so the catalogue answers 'what is this for', not just 'what does this expose'.
What developers build with this provider.
Architecture Reviews and Governance
Evaluate cloud workload architecture quality against AWS best practices across the five Well-Architected pillars.
Multi-Workload Standardization
Use review templates to standardize architectural answers and enforce consistent governance across multiple workloads and teams.
Industry-Specific Best Practice Implementation
Apply industry-specific and technology-specific lenses from the lens catalog to assess specialized workloads.
Regulatory Compliance Assessment
Evaluate workloads for FedRAMP, GovCloud, and other regulatory compliance requirements through targeted lenses.
DevOps Pipeline Integration
Integrate Well-Architected reviews into CI/CD workflows and automation pipelines for continuous architecture assessment.
Cross-Team Architectural Alignment
Share workloads with reviewers and stakeholders to facilitate collaborative architectural decision-making across teams.
Sustainability Goal Realization
Use the sustainability pillar to minimize environmental impact and meet organizational sustainability commitments.
Scroll within the panel for all 7 ·
Resources
Every other property we hold for Amazon Well-Architected Tool — documentation, portals, status pages, policies, and corporate surface — grouped by the job it does, following the integrator's arc from getting started to running in production.
Get Started 4
Portal, sign-up, and the first successful call
Documentation 1
Reference material describing how the API behaves
Agent Surfaces 1
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 15
Pagination, idempotency, versioning, errors, and events
Scroll within the panel for all 15 ·
Build 3
SDKs, sample code, and the tooling you integrate with
Access & Security 5
Authentication, authorization, and security posture
Operate 2
Status, limits, changes, and where to get help
Commercial 2
Pricing, plans, and the legal terms of use
Company 1
The organization behind the API
← All providers · Data indexed from github.com/api-evangelist/amazon-well-architected-tool · machine-readable index on apis.io