AWS CloudFormation

AWS CloudFormation Stack Sets API

Operations for managing stack sets across multiple accounts and regions.

GitHub OpenAPI

Operations 5

POST /?Action=CreateStackSet Create a Stack Set #
POST /?Action=DescribeStackSet Describe a Stack Set #
POST /?Action=UpdateStackSet Update a Stack Set #
POST /?Action=DeleteStackSet Delete a Stack Set #
POST /?Action=ListStackSets List All Stack Sets #

Documentation

📖
Documentation
https://docs.aws.amazon.com/cloudformation/
📖
APIReference
https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html
📖
GettingStarted
https://aws.amazon.com/cloudformation/getting-started/
📖
Documentation
https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/what-is-cloudcontrolapi.html
📖
APIReference
https://docs.aws.amazon.com/cloudcontrolapi/index.html

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/cloudformation/refs/heads/main/openapi/cloudformation-stack-sets-api-openapi.yml

Other Resources

🔗
Pricing
https://aws.amazon.com/cloudformation/pricing/
🔗
ChangeLog
https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/document-history.html
🔗
SDKs
https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/cloudformation.html

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-sets-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

cloudformation-stack-sets-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: AWS CloudFormation Stack Sets 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 Sets
  description: Operations for managing stack sets across multiple accounts and regions.
paths:
  /?Action=CreateStackSet:
    post:
      operationId: createStackSet
      summary: Create a Stack Set
      description: Creates a stack set with the specified name and template. A stack set lets you create stacks in AWS accounts across regions by using a single CloudFormation template.
      tags:
      - Stack Sets
      parameters:
      - $ref: '#/components/parameters/VersionParam'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - StackSetName
              properties:
                StackSetName:
                  type: string
                  maxLength: 128
                Description:
                  type: string
                  maxLength: 1024
                TemplateBody:
                  type: string
                TemplateURL:
                  type: string
                  format: uri
                Parameters:
                  type: array
                  items:
                    $ref: '#/components/schemas/Parameter'
                Capabilities:
                  type: array
                  items:
                    type: string
                    enum:
                    - CAPABILITY_IAM
                    - CAPABILITY_NAMED_IAM
                    - CAPABILITY_AUTO_EXPAND
                Tags:
                  type: array
                  items:
                    $ref: '#/components/schemas/Tag'
                  maxItems: 50
                AdministrationRoleARN:
                  type: string
                  minLength: 20
                  maxLength: 2048
                ExecutionRoleName:
                  type: string
                  minLength: 1
                  maxLength: 64
                PermissionModel:
                  type: string
                  enum:
                  - SERVICE_MANAGED
                  - SELF_MANAGED
                CallAs:
                  type: string
                  enum:
                  - SELF
                  - DELEGATED_ADMIN
                ClientRequestToken:
                  type: string
                  maxLength: 128
            examples:
              CreatestacksetRequestExample:
                summary: Default createStackSet request
                x-microcks-default: true
                value:
                  StackSetName: example_value
                  Description: A sample description.
                  TemplateBody: example_value
                  TemplateURL: https://www.example.com
                  Parameters:
                  - ParameterKey: example_value
                    ParameterValue: example_value
                    UsePreviousValue: true
                    ResolvedValue: example_value
                  Capabilities:
                  - CAPABILITY_IAM
                  Tags:
                  - Key: example_value
                    Value: example_value
                  AdministrationRoleARN: example_value
                  ExecutionRoleName: example_value
                  PermissionModel: SERVICE_MANAGED
                  CallAs: SELF
                  ClientRequestToken: example_value
      responses:
        '200':
          description: Stack set created.
          content:
            application/xml:
              schema:
                type: object
                properties:
                  CreateStackSetResult:
                    type: object
                    properties:
                      StackSetId:
                        type: string
              examples:
                Createstackset200Example:
                  summary: Default createStackSet 200 response
                  x-microcks-default: true
                  value:
                    CreateStackSetResult:
                      StackSetId: '500123'
        '400':
          $ref: '#/components/responses/ValidationError'
        '409':
          $ref: '#/components/responses/AlreadyExistsError'
        '500':
          $ref: '#/components/responses/InternalError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /?Action=DescribeStackSet:
    post:
      operationId: describeStackSet
      summary: Describe a Stack Set
      description: Returns the description of the specified stack set.
      tags:
      - Stack Sets
      parameters:
      - $ref: '#/components/parameters/VersionParam'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - StackSetName
              properties:
                StackSetName:
                  type: string
                CallAs:
                  type: string
                  enum:
                  - SELF
                  - DELEGATED_ADMIN
            examples:
              DescribestacksetRequestExample:
                summary: Default describeStackSet request
                x-microcks-default: true
                value:
                  StackSetName: example_value
                  CallAs: SELF
      responses:
        '200':
          description: Stack set details returned.
          content:
            application/xml:
              schema:
                type: object
                properties:
                  DescribeStackSetResult:
                    type: object
                    properties:
                      StackSet:
                        $ref: '#/components/schemas/StackSet'
              examples:
                Describestackset200Example:
                  summary: Default describeStackSet 200 response
                  x-microcks-default: true
                  value:
                    DescribeStackSetResult:
                      StackSet:
                        StackSetName: example_value
                        StackSetId: '500123'
                        Description: A sample description.
                        Status: ACTIVE
                        TemplateBody: example_value
                        Parameters:
                        - {}
                        Capabilities:
                        - {}
                        Tags:
                        - {}
                        StackSetARN: example_value
                        AdministrationRoleARN: example_value
                        ExecutionRoleName: example_value
                        PermissionModel: SERVICE_MANAGED
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /?Action=UpdateStackSet:
    post:
      operationId: updateStackSet
      summary: Update a Stack Set
      description: Updates the stack set, and associated stack instances in the specified accounts and regions.
      tags:
      - Stack Sets
      parameters:
      - $ref: '#/components/parameters/VersionParam'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - StackSetName
              properties:
                StackSetName:
                  type: string
                Description:
                  type: string
                  maxLength: 1024
                TemplateBody:
                  type: string
                TemplateURL:
                  type: string
                  format: uri
                UsePreviousTemplate:
                  type: boolean
                Parameters:
                  type: array
                  items:
                    $ref: '#/components/schemas/Parameter'
                Capabilities:
                  type: array
                  items:
                    type: string
                Tags:
                  type: array
                  items:
                    $ref: '#/components/schemas/Tag'
                  maxItems: 50
                OperationPreferences:
                  $ref: '#/components/schemas/StackSetOperationPreferences'
                AdministrationRoleARN:
                  type: string
                  minLength: 20
                  maxLength: 2048
                ExecutionRoleName:
                  type: string
                PermissionModel:
                  type: string
                  enum:
                  - SERVICE_MANAGED
                  - SELF_MANAGED
                Accounts:
                  type: array
                  items:
                    type: string
                Regions:
                  type: array
                  items:
                    type: string
                CallAs:
                  type: string
                  enum:
                  - SELF
                  - DELEGATED_ADMIN
                OperationId:
                  type: string
                  maxLength: 128
            examples:
              UpdatestacksetRequestExample:
                summary: Default updateStackSet request
                x-microcks-default: true
                value:
                  StackSetName: example_value
                  Description: A sample description.
                  TemplateBody: example_value
                  TemplateURL: https://www.example.com
                  UsePreviousTemplate: true
                  Parameters:
                  - ParameterKey: example_value
                    ParameterValue: example_value
                    UsePreviousValue: true
                    ResolvedValue: example_value
                  Capabilities:
                  - example_value
                  Tags:
                  - Key: example_value
                    Value: example_value
                  OperationPreferences:
                    RegionConcurrencyType: SEQUENTIAL
                    RegionOrder:
                    - example_value
                    FailureToleranceCount: 10
                    FailureTolerancePercentage: 10
                    MaxConcurrentCount: 10
                    MaxConcurrentPercentage: 10
                  AdministrationRoleARN: example_value
                  ExecutionRoleName: example_value
                  PermissionModel: SERVICE_MANAGED
                  Accounts:
                  - example_value
                  Regions:
                  - example_value
                  CallAs: SELF
                  OperationId: '500123'
      responses:
        '200':
          description: Stack set update initiated.
          content:
            application/xml:
              schema:
                type: object
                properties:
                  UpdateStackSetResult:
                    type: object
                    properties:
                      OperationId:
                        type: string
              examples:
                Updatestackset200Example:
                  summary: Default updateStackSet 200 response
                  x-microcks-default: true
                  value:
                    UpdateStackSetResult:
                      OperationId: '500123'
        '400':
          $ref: '#/components/responses/ValidationError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /?Action=DeleteStackSet:
    post:
      operationId: deleteStackSet
      summary: Delete a Stack Set
      description: Deletes a stack set. Before you can delete a stack set, all its member stack instances must be deleted.
      tags:
      - Stack Sets
      parameters:
      - $ref: '#/components/parameters/VersionParam'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - StackSetName
              properties:
                StackSetName:
                  type: string
                CallAs:
                  type: string
                  enum:
                  - SELF
                  - DELEGATED_ADMIN
            examples:
              DeletestacksetRequestExample:
                summary: Default deleteStackSet request
                x-microcks-default: true
                value:
                  StackSetName: example_value
                  CallAs: SELF
      responses:
        '200':
          description: Stack set deleted.
        '400':
          $ref: '#/components/responses/ValidationError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '409':
          description: Stack set has active instances and cannot be deleted.
        '500':
          $ref: '#/components/responses/InternalError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /?Action=ListStackSets:
    post:
      operationId: listStackSets
      summary: List All Stack Sets
      description: Returns summary information about stack sets in the caller's account.
      tags:
      - Stack Sets
      parameters:
      - $ref: '#/components/parameters/VersionParam'
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                NextToken:
                  type: string
                  maxLength: 1024
                MaxResults:
                  type: integer
                  minimum: 1
                  maximum: 100
                Status:
                  type: string
                  enum:
                  - ACTIVE
                  - DELETED
                CallAs:
                  type: string
                  enum:
                  - SELF
                  - DELEGATED_ADMIN
            examples:
              ListstacksetsRequestExample:
                summary: Default listStackSets request
                x-microcks-default: true
                value:
                  NextToken: example_value
                  MaxResults: 10
                  Status: ACTIVE
                  CallAs: SELF
      responses:
        '200':
          description: Stack set summaries returned.
          content:
            application/xml:
              schema:
                type: object
                properties:
                  ListStackSetsResult:
                    type: object
                    properties:
                      Summaries:
                        type: array
                        items:
                          $ref: '#/components/schemas/StackSetSummary'
                      NextToken:
                        type: string
              examples:
                Liststacksets200Example:
                  summary: Default listStackSets 200 response
                  x-microcks-default: true
                  value:
                    ListStackSetsResult:
                      Summaries:
                      - StackSetName: example_value
                        StackSetId: '500123'
                        Description: A sample description.
                        Status: ACTIVE
                        PermissionModel: SERVICE_MANAGED
                        DriftStatus: DRIFTED
                        LastDriftCheckTimestamp: '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
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'
    StackSetSummary:
      type: object
      properties:
        StackSetName:
          type: string
          example: example_value
        StackSetId:
          type: string
          example: '500123'
        Description:
          type: string
          example: A sample description.
        Status:
          type: string
          enum:
          - ACTIVE
          - DELETED
          example: ACTIVE
        PermissionModel:
          type: string
          enum:
          - SERVICE_MANAGED
          - SELF_MANAGED
          example: SERVICE_MANAGED
        DriftStatus:
          type: string
          enum:
          - DRIFTED
          - IN_SYNC
          - NOT_CHECKED
          example: DRIFTED
        LastDriftCheckTimestamp:
          type: string
          format: date-time
          example: '2026-01-15T10:30:00Z'
    StackSet:
      type: object
      properties:
        StackSetName:
          type: string
          example: example_value
        StackSetId:
          type: string
          example: '500123'
        Description:
          type: string
          example: A sample description.
        Status:
          type: string
          enum:
          - ACTIVE
          - DELETED
          example: ACTIVE
        TemplateBody:
          type: string
          example: example_value
        Parameters:
          type: array
          items:
            $ref: '#/components/schemas/Parameter'
          example: []
        Capabilities:
          type: array
          items:
            type: string
          example: []
        Tags:
          type: array
          items:
            $ref: '#/components/schemas/Tag'
          example: []
        StackSetARN:
          type: string
          example: example_value
        AdministrationRoleARN:
          type: string
          example: example_value
        ExecutionRoleName:
          type: string
          example: example_value
        PermissionModel:
          type: string
          enum:
          - SERVICE_MANAGED
          - SELF_MANAGED
          example: SERVICE_MANAGED
    Tag:
      type: object
      required:
      - Key
      - Value
      properties:
        Key:
          type: string
          description: Tag key.
          minLength: 1
          maxLength: 128
          example: example_value
        Value:
          type: string
          description: Tag value.
          minLength: 0
          maxLength: 256
          example: example_value
    StackSetOperationPreferences:
      type: object
      properties:
        RegionConcurrencyType:
          type: string
          enum:
          - SEQUENTIAL
          - PARALLEL
          example: SEQUENTIAL
        RegionOrder:
          type: array
          items:
            type: string
          example: []
        FailureToleranceCount:
          type: integer
          minimum: 0
          example: 10
        FailureTolerancePercentage:
          type: integer
          minimum: 0
          maximum: 100
          example: 10
        MaxConcurrentCount:
          type: integer
          minimum: 1
          example: 10
        MaxConcurrentPercentage:
          type: integer
          minimum: 1
          maximum: 100
          example: 10
    Parameter:
      type: object
      properties:
        ParameterKey:
          type: string
          description: The key associated with the parameter.
          example: example_value
        ParameterValue:
          type: string
          description: The input value associated with the parameter.
          example: example_value
        UsePreviousValue:
          type: boolean
          description: Use the existing parameter value during stack updates.
          example: true
        ResolvedValue:
          type: string
          description: The value that resolves to for SSM parameter types.
          example: example_value
  parameters:
    VersionParam:
      name: Version
      in: query
      required: true
      schema:
        type: string
        default: '2010-05-15'
      description: The API version. Fixed to 2010-05-15.
  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'
    AlreadyExistsError:
      description: The resource already exists.
      content:
        application/xml:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFoundError:
      description: The specified resource was not found.
      content:
        application/xml:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    AWS_Signature_V4:
      type: apiKey
      name: Authorization
      in: header
      description: AWS Signature Version 4 authentication.