Welcome

This is the AWS Well-Architected API Reference. AWS Well-Architected helps you evaluate your architectures against AWS best practices across operational excellence, security, reliability, performance efficiency, cost optimization, and sustainability.

To view API actions organized by service, see API actions.

AWS Well-Architected Agent (preview)

Describes the API operations for managing optimization profiles, goals, application context, and recommendations in the AWS Well-Architected Agent. Through this API, you can create and configure agent profiles that define the scope of your AWS environment to analyze, set optimization goals across cost, security, performance, and resilience pillars, start recommendation generation, retrieve prioritized recommendations with ready-to-deploy remediation scripts, and provide feedback to improve future recommendations.

For more information, see What is AWS Well-Architected Agent?

AWS Well-Architected Tool

Describes the API operations for creating and managing workloads, conducting lens reviews, tracking milestones, managing custom lenses, sharing workloads across accounts, and managing profiles with the AWS Well-Architected Tool.

For more information, see What is AWS Well-Architected Tool?

This document was last published on October 1, 2026.