AWS CloudFormation

AWS CloudFormation Stack Drift API

Operations for detecting and describing configuration drift.

Documentation GitHub OpenAPI

Operations 4

POST /?Action=DetectStackDrift Detect Configuration Drift on a Stack #

POST /?Action=DescribeStackDriftDetectionStatus Check Status of Drift Detection #

POST /?Action=DescribeStackResourceDrifts Get Drift Information for Stack Resources #

POST /?Action=DetectStackResourceDrift Detect Drift on a Specific Resource #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/cloudformation-stack-drift-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: AWS CloudFormation Stack Drift API
  description: AWS CloudFormation gives you an easy way to model a collection of related AWS and third-party resources, provision them quickly and consistently, and manage them throughout their lifecycles. It uses templates to define stacks of resources and provides API operations for creating, updating, and deleting stacks. The API uses a query-style interface where all operations are submitted as POST requests with an Action parameter.
  version: '2010-05-15'
  contact:
    name: AWS Support
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  x-logo:
    url: https://aws.amazon.com/cloudformation/logo.png
servers:
- url: https://cloudformation.{region}.amazonaws.com
  description: AWS CloudFormation Regional Endpoint
  variables:
    region:
      default: us-east-1
      description: AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - eu-west-1
      - eu-west-2
      - eu-central-1
      - ap-southeast-1
      - ap-southeast-2
      - ap-northeast-1
security:
- AWS_Signature_V4: []
tags:
- name: Stack Drift
  description: Operations for detecting and describing configuration drift.
paths:
  /?Action=DetectStackDrift:
    post:
      operationId: detectStackDrift
      summary: Detect Configuration Drift on a Stack
      description: Detects whether a stack's actual configuration differs from its expected configuration as defined in the stack template. Returns a drift detection ID you can use to monitor the progress of the operation.
      tags:
      - Stack Drift
      parameters:
      - $ref: '#/components/parameters/VersionParam'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - StackName
              properties:
                StackName:
                  type: string
                LogicalResourceIds:
                  type: array
                  items:
                    type: string
            examples:
              DetectstackdriftRequestExample:
                summary: Default detectStackDrift request
                x-microcks-default: true
                value:
                  StackName: example_value
                  LogicalResourceIds:
                  - example_value
      responses:
        '200':
          description: Drift detection initiated.
          content:
            application/xml:
              schema:
                type: object
                properties:
                  DetectStackDriftResult:
                    type: object
                    properties:
                      StackDriftDetectionId:
                        type: string
              examples:
                Detectstackdrift200Example:
                  summary: Default detectStackDrift 200 response
                  x-microcks-default: true
                  value:
                    DetectStackDriftResult:
                      StackDriftDetectionId: '500123'
        '400':
          $ref: '#/components/responses/ValidationError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /?Action=DescribeStackDriftDetectionStatus:
    post:
      operationId: describeStackDriftDetectionStatus
      summary: Check Status of Drift Detection
      description: Returns information about a stack drift detection operation. Provides the current status and results of the operation.
      tags:
      - Stack Drift
      parameters:
      - $ref: '#/components/parameters/VersionParam'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - StackDriftDetectionId
              properties:
                StackDriftDetectionId:
                  type: string
                  description: The ID of the drift detection operation.
            examples:
              DescribestackdriftdetectionstatusRequestExample:
                summary: Default describeStackDriftDetectionStatus request
                x-microcks-default: true
                value:
                  StackDriftDetectionId: '500123'
      responses:
        '200':
          description: Drift detection status returned.
          content:
            application/xml:
              schema:
                type: object
                properties:
                  DescribeStackDriftDetectionStatusResult:
                    type: object
                    properties:
                      StackId:
                        type: string
                      StackDriftDetectionId:
                        type: string
                      StackDriftStatus:
                        type: string
                        enum:
                        - DRIFTED
                        - IN_SYNC
                        - UNKNOWN
                        - NOT_CHECKED
                      DetectionStatus:
                        type: string
                        enum:
                        - DETECTION_IN_PROGRESS
                        - DETECTION_FAILED
                        - DETECTION_COMPLETE
                      DetectionStatusReason:
                        type: string
                      DriftedStackResourceCount:
                        type: integer
                      Timestamp:
                        type: string
                        format: date-time
              examples:
                Describestackdriftdetectionstatus200Example:
                  summary: Default describeStackDriftDetectionStatus 200 response
                  x-microcks-default: true
                  value:
                    DescribeStackDriftDetectionStatusResult:
                      StackId: '500123'
                      StackDriftDetectionId: '500123'
                      StackDriftStatus: DRIFTED
                      DetectionStatus: DETECTION_IN_PROGRESS
                      DetectionStatusReason: example_value
                      DriftedStackResourceCount: 10
                      Timestamp: '2026-01-15T10:30:00Z'
        '400':
          $ref: '#/components/responses/ValidationError'
        '500':
          $ref: '#/components/responses/InternalError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /?Action=DescribeStackResourceDrifts:
    post:
      operationId: describeStackResourceDrifts
      summary: Get Drift Information for Stack Resources
      description: Returns drift information for the resources that have been checked for drift in the specified stack.
      tags:
      - Stack Drift
      parameters:
      - $ref: '#/components/parameters/VersionParam'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - StackName
              properties:
                StackName:
                  type: string
                StackResourceDriftStatusFilters:
                  type: array
                  items:
                    type: string
                    enum:
                    - IN_SYNC
                    - MODIFIED
                    - DELETED
                    - NOT_CHECKED
                NextToken:
                  type: string
                  maxLength: 1024
                MaxResults:
                  type: integer
                  minimum: 1
                  maximum: 100
            examples:
              DescribestackresourcedriftsRequestExample:
                summary: Default describeStackResourceDrifts request
                x-microcks-default: true
                value:
                  StackName: example_value
                  StackResourceDriftStatusFilters:
                  - IN_SYNC
                  NextToken: example_value
                  MaxResults: 10
      responses:
        '200':
          description: Resource drift information returned.
          content:
            application/xml:
              schema:
                type: object
                properties:
                  DescribeStackResourceDriftsResult:
                    type: object
                    properties:
                      StackResourceDrifts:
                        type: array
                        items:
                          $ref: '#/components/schemas/StackResourceDrift'
                      NextToken:
                        type: string
              examples:
                Describestackresourcedrifts200Example:
                  summary: Default describeStackResourceDrifts 200 response
                  x-microcks-default: true
                  value:
                    DescribeStackResourceDriftsResult:
                      StackResourceDrifts:
                      - StackId: '500123'
                        LogicalResourceId: '500123'
                        PhysicalResourceId: '500123'
                        PhysicalResourceIdContext: {}
                        ResourceType: example_value
                        ExpectedProperties: example_value
                        ActualProperties: example_value
                        PropertyDifferences: {}
                        StackResourceDriftStatus: IN_SYNC
                        Timestamp: '2026-01-15T10:30:00Z'
                      NextToken: example_value
        '400':
          $ref: '#/components/responses/ValidationError'
        '500':
          $ref: '#/components/responses/InternalError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /?Action=DetectStackResourceDrift:
    post:
      operationId: detectStackResourceDrift
      summary: Detect Drift on a Specific Resource
      description: Returns information about whether a resource's actual configuration differs from its expected configuration.
      tags:
      - Stack Drift
      parameters:
      - $ref: '#/components/parameters/VersionParam'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - StackName
              - LogicalResourceId
              properties:
                StackName:
                  type: string
                LogicalResourceId:
                  type: string
            examples:
              DetectstackresourcedriftRequestExample:
                summary: Default detectStackResourceDrift request
                x-microcks-default: true
                value:
                  StackName: example_value
                  LogicalResourceId: '500123'
      responses:
        '200':
          description: Resource drift detection result returned.
          content:
            application/xml:
              schema:
                type: object
                properties:
                  DetectStackResourceDriftResult:
                    type: object
                    properties:
                      StackResourceDrift:
                        $ref: '#/components/schemas/StackResourceDrift'
              examples:
                Detectstackresourcedrift200Example:
                  summary: Default detectStackResourceDrift 200 response
                  x-microcks-default: true
                  value:
                    DetectStackResourceDriftResult:
                      StackResourceDrift:
                        StackId: '500123'
                        LogicalResourceId: '500123'
                        PhysicalResourceId: '500123'
                        PhysicalResourceIdContext:
                        - {}
                        ResourceType: example_value
                        ExpectedProperties: example_value
                        ActualProperties: example_value
                        PropertyDifferences:
                        - {}
                        StackResourceDriftStatus: IN_SYNC
                        Timestamp: '2026-01-15T10:30:00Z'
        '400':
          $ref: '#/components/responses/ValidationError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        Error:
          type: object
          properties:
            Type:
              type: string
            Code:
              type: string
            Message:
              type: string
          example: example_value
        RequestId:
          type: string
          example: '500123'
    StackResourceDrift:
      type: object
      required:
      - StackId
      - LogicalResourceId
      - ResourceType
      - StackResourceDriftStatus
      - Timestamp
      properties:
        StackId:
          type: string
          example: '500123'
        LogicalResourceId:
          type: string
          example: '500123'
        PhysicalResourceId:
          type: string
          example: '500123'
        PhysicalResourceIdContext:
          type: array
          items:
            type: object
            properties:
              Key:
                type: string
              Value:
                type: string
          example: []
        ResourceType:
          type: string
          example: example_value
        ExpectedProperties:
          type: string
          description: A JSON string of the expected property values as defined in the template.
          example: example_value
        ActualProperties:
          type: string
          description: A JSON string of the actual property values of the resource.
          example: example_value
        PropertyDifferences:
          type: array
          items:
            $ref: '#/components/schemas/PropertyDifference'
          example: []
        StackResourceDriftStatus:
          type: string
          enum:
          - IN_SYNC
          - MODIFIED
          - DELETED
          - NOT_CHECKED
          example: IN_SYNC
        Timestamp:
          type: string
          format: date-time
          example: '2026-01-15T10:30:00Z'
    PropertyDifference:
      type: object
      required:
      - PropertyPath
      - ExpectedValue
      - ActualValue
      - DifferenceType
      properties:
        PropertyPath:
          type: string
          example: example_value
        ExpectedValue:
          type: string
          example: example_value
        ActualValue:
          type: string
          example: example_value
        DifferenceType:
          type: string
          enum:
          - ADD
          - REMOVE
          - NOT_EQUAL
          example: ADD
  responses:
    InternalError:
      description: An internal service error occurred.
      content:
        application/xml:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    ValidationError:
      description: The input fails to satisfy the constraints specified by the service.
      content:
        application/xml:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFoundError:
      description: The specified resource was not found.
      content:
        application/xml:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  parameters:
    VersionParam:
      name: Version
      in: query
      required: true
      schema:
        type: string
        default: '2010-05-15'
      description: The API version. Fixed to 2010-05-15.
  securitySchemes:
    AWS_Signature_V4:
      type: apiKey
      name: Authorization
      in: header
      description: AWS Signature Version 4 authentication.