Amazon CloudFormation Cloudformation Stack Refactor API

The Cloudformation Stack Refactor API from Amazon CloudFormation — 4 operation(s) for cloudformation stack refactor.

Operations 4

POST /?Action=CreateStackRefactor Create Stack Refactor #
POST /?Action=DescribeStackRefactor Describe Stack Refactor #
POST /?Action=ExecuteStackRefactor Execute Stack Refactor #
POST /?Action=ListStackRefactors List Stack Refactors #

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/amazon-cloudformation:amazon-cloudformation-stack-refactor-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.

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

OpenAPI Specification

amazon-cloudformation-stack-refactor-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: AWS CloudFormation Stack Refactor API
  version: '2010-05-15'
  description: Generated from AWS's published Smithy model for AWS CloudFormation. 4 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://cloudformation.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
tags:
- name: Stack Refactor
paths:
  /?Action=CreateStackRefactor:
    post:
      operationId: CreateStackRefactor
      summary: Create Stack Refactor
      description: Creates a refactor across multiple stacks, with the list of stacks and resources that are affected.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/CreateStackRefactorOutput'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              allOf:
              - type: object
                required:
                - Action
                - Version
                properties:
                  Action:
                    type: string
                    const: CreateStackRefactor
                  Version:
                    type: string
                    const: '2010-05-15'
              - $ref: '#/components/schemas/CreateStackRefactorInput'
      tags:
      - Stack Refactor
  /?Action=DescribeStackRefactor:
    post:
      operationId: DescribeStackRefactor
      summary: Describe Stack Refactor
      description: Describes the stack refactor status.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/DescribeStackRefactorOutput'
        '404':
          description: StackRefactorNotFoundException
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/StackRefactorNotFoundException'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              allOf:
              - type: object
                required:
                - Action
                - Version
                properties:
                  Action:
                    type: string
                    const: DescribeStackRefactor
                  Version:
                    type: string
                    const: '2010-05-15'
              - $ref: '#/components/schemas/DescribeStackRefactorInput'
      tags:
      - Stack Refactor
  /?Action=ExecuteStackRefactor:
    post:
      operationId: ExecuteStackRefactor
      summary: Execute Stack Refactor
      description: Executes the stack refactor operation.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                type: string
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              allOf:
              - type: object
                required:
                - Action
                - Version
                properties:
                  Action:
                    type: string
                    const: ExecuteStackRefactor
                  Version:
                    type: string
                    const: '2010-05-15'
              - $ref: '#/components/schemas/ExecuteStackRefactorInput'
      tags:
      - Stack Refactor
  /?Action=ListStackRefactors:
    post:
      operationId: ListStackRefactors
      summary: List Stack Refactors
      description: Lists all account stack refactor operations and their statuses.
      responses:
        '200':
          description: Success
          content:
            text/xml:
              schema:
                $ref: '#/components/schemas/ListStackRefactorsOutput'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              allOf:
              - type: object
                required:
                - Action
                - Version
                properties:
                  Action:
                    type: string
                    const: ListStackRefactors
                  Version:
                    type: string
                    const: '2010-05-15'
              - $ref: '#/components/schemas/ListStackRefactorsInput'
      tags:
      - Stack Refactor
components:
  schemas:
    StackRefactorNotFoundException:
      type: object
      properties:
        Message:
          type: string
    ResourceLocation:
      type: object
      properties:
        StackName:
          type: string
          description: The name associated with the stack.
        LogicalResourceId:
          type: string
          description: The logical name of the resource specified in the template.
      required:
      - StackName
      - LogicalResourceId
    DescribeStackRefactorOutput:
      type: object
      properties:
        Description:
          type: string
          description: A description to help you identify the refactor.
        StackRefactorId:
          type: string
          description: The ID associated with the stack refactor created from the CreateStackRefactor action.
        StackIds:
          type: array
          items:
            type: string
          description: The unique ID for each stack.
        ExecutionStatus:
          type: string
          enum:
          - UNAVAILABLE
          - AVAILABLE
          - OBSOLETE
          - EXECUTE_IN_PROGRESS
          - EXECUTE_COMPLETE
          - EXECUTE_FAILED
          - ROLLBACK_IN_PROGRESS
          - ROLLBACK_COMPLETE
          - ROLLBACK_FAILED
          description: The stack refactor execution operation status that's provided after calling the ExecuteStackRefactor action.
        ExecutionStatusReason:
          type: string
          description: A detailed explanation for the stack refactor ExecutionStatus.
        Status:
          type: string
          enum:
          - CREATE_IN_PROGRESS
          - CREATE_COMPLETE
          - CREATE_FAILED
          - DELETE_IN_PROGRESS
          - DELETE_COMPLETE
          - DELETE_FAILED
          description: The stack refactor operation status that's provided after calling the CreateStackRefactor action.
        StatusReason:
          type: string
          description: A detailed explanation for the stack refactor operation Status.
    ResourceMapping:
      type: object
      properties:
        Source:
          $ref: '#/components/schemas/ResourceLocation'
        Destination:
          $ref: '#/components/schemas/ResourceLocation'
      required:
      - Source
      - Destination
    ListStackRefactorsOutput:
      type: object
      properties:
        StackRefactorSummaries:
          type: array
          items:
            $ref: '#/components/schemas/StackRefactorSummary'
          description: 'Provides a summary of a stack refactor, including the following: StackRefactorId Status StatusReason ExecutionStatus ExecutionStatusReason Description'
        NextToken:
          type: string
          description: If the request doesn't return all the remaining results, NextToken is set to a token. To retrieve the next set of results, call this action again and assign that token to the request object's NextToken parameter. If the request returns all results, NextToken is set to null.
      required:
      - StackRefactorSummaries
    CreateStackRefactorInput:
      type: object
      properties:
        Description:
          type: string
          description: A description to help you identify the stack refactor.
        EnableStackCreation:
          type: boolean
          description: Determines if a new stack is created with the refactor.
        ResourceMappings:
          type: array
          items:
            $ref: '#/components/schemas/ResourceMapping'
          description: The mappings for the stack resource Source and stack resource Destination.
        StackDefinitions:
          type: array
          items:
            $ref: '#/components/schemas/StackDefinition'
          description: The stacks being refactored.
      required:
      - StackDefinitions
    ListStackRefactorsInput:
      type: object
      properties:
        ExecutionStatusFilter:
          type: array
          items:
            type: string
            enum:
            - UNAVAILABLE
            - AVAILABLE
            - OBSOLETE
            - EXECUTE_IN_PROGRESS
            - EXECUTE_COMPLETE
            - EXECUTE_FAILED
            - ROLLBACK_IN_PROGRESS
            - ROLLBACK_COMPLETE
            - ROLLBACK_FAILED
          description: Execution status to use as a filter. Specify one or more execution status codes to list only stack refactors with the specified execution status codes.
        NextToken:
          type: string
          description: The token for the next set of items to return. (You received this token from a previous call.)
        MaxResults:
          type: integer
          description: The maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.
    CreateStackRefactorOutput:
      type: object
      properties:
        StackRefactorId:
          type: string
          description: The ID associated with the stack refactor created from the CreateStackRefactor action.
      required:
      - StackRefactorId
    ExecuteStackRefactorInput:
      type: object
      properties:
        StackRefactorId:
          type: string
          description: The ID associated with the stack refactor created from the CreateStackRefactor action.
      required:
      - StackRefactorId
    StackDefinition:
      type: object
      properties:
        StackName:
          type: string
          description: The name associated with the stack.
        TemplateBody:
          type: string
          description: The file path for the stack template file.
        TemplateURL:
          type: string
          description: The desired final state of the stack template.
    StackRefactorSummary:
      type: object
      properties:
        StackRefactorId:
          type: string
          description: The ID associated with the stack refactor created from the CreateStackRefactor action.
        Description:
          type: string
          description: A description to help you identify the refactor.
        ExecutionStatus:
          type: string
          enum:
          - UNAVAILABLE
          - AVAILABLE
          - OBSOLETE
          - EXECUTE_IN_PROGRESS
          - EXECUTE_COMPLETE
          - EXECUTE_FAILED
          - ROLLBACK_IN_PROGRESS
          - ROLLBACK_COMPLETE
          - ROLLBACK_FAILED
          description: The operation status that's provided after calling the ExecuteStackRefactor action.
        ExecutionStatusReason:
          type: string
          description: A detailed explanation for the stack refactor ExecutionStatus.
        Status:
          type: string
          enum:
          - CREATE_IN_PROGRESS
          - CREATE_COMPLETE
          - CREATE_FAILED
          - DELETE_IN_PROGRESS
          - DELETE_COMPLETE
          - DELETE_FAILED
          description: The stack refactor operation status that's provided after calling the CreateStackRefactor action.
        StatusReason:
          type: string
          description: A detailed explanation for the stack refactor Status.
    DescribeStackRefactorInput:
      type: object
      properties:
        StackRefactorId:
          type: string
          description: The ID associated with the stack refactor created from the CreateStackRefactor action.
      required:
      - StackRefactorId
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: cloudformation
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/cloudformation/service/2010-05-15/cloudformation-2010-05-15.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)