AWS Security Hub Controls API

The Controls API from AWS Security Hub — 3 operation(s) for controls.

GitHub OpenAPI
Business capability
Security Strategy & Governance Management BC-620.10

Operations 3

GET /standards/controls/{StandardsSubscriptionArn+} Describe Standards Controls #
POST /securityControls/batchGet Batch Get Security Controls #
GET /securityControls/definitions List Security Control Definitions #

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/aws-security-hub:aws-security-hub-controls-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

aws-security-hub-controls-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: AWS SecurityHub Controls API
  version: '2018-10-26'
  description: Generated from AWS's published Smithy model for AWS SecurityHub. 3 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://securityhub.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /standards/controls/{StandardsSubscriptionArn+}:
    get:
      operationId: DescribeStandardsControls
      summary: Describe Standards Controls
      description: Returns a list of security standards controls. For each control, the results include information about
        whether it is currently enabled, the severity, and a link to remediation information. This operation returns an empty
        list for standard subscriptions where StandardsControlsUpdatable has value NOT_READY_FOR_UPDATES.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DescribeStandardsControlsResponse'
        '500':
          description: InternalException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalException'
        '401':
          description: InvalidAccessException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidAccessException'
        '400':
          description: InvalidInputException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidInputException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DescribeStandardsControlsRequest'
      tags:
      - Controls
  /securityControls/batchGet:
    post:
      operationId: BatchGetSecurityControls
      summary: Batch Get Security Controls
      description: Provides details about a batch of security controls for the current Amazon Web Services account and Amazon
        Web Services Region.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchGetSecurityControlsResponse'
              example:
                SecurityControls:
                - SecurityControlId: ACM.1
                  SecurityControlArn: arn:aws:securityhub:us-west-2:123456789012:security-control/ACM.1
                  Title: Imported and ACM-issued certificates should be renewed after a specified time period
                  Description: This AWS control checks whether ACM Certificates in your account are marked for expiration
                    within a specified time period. Certificates provided by ACM are automatically renewed. ACM does not automatically
                    renew certificates that you import.
                  RemediationUrl: https://docs.aws.amazon.com/console/securityhub/ACM.1/remediation
                  SeverityRating: MEDIUM
                  SecurityControlStatus: ENABLED
                  UpdateStatus: UPDATING
                  Parameters:
                    daysToExpiration:
                      ValueType: DEFAULT
                      Value:
                        Integer: 30
                  LastUpdateReason: Stayed with default value
                  Provider: AWS
                - SecurityControlId: APIGateway.1
                  SecurityControlArn: arn:aws:securityhub:us-west-2:123456789012:security-control/APIGateway.1
                  Title: API Gateway REST and WebSocket API execution logging should be enabled
                  Description: This control checks whether all stages of Amazon API Gateway REST and WebSocket APIs have logging
                    enabled. The control fails if logging is not enabled for all methods of a stage or if loggingLevel is
                    neither ERROR nor INFO.
                  RemediationUrl: https://docs.aws.amazon.com/console/securityhub/APIGateway.1/remediation
                  SeverityRating: MEDIUM
                  SecurityControlStatus: ENABLED
                  UpdateStatus: UPDATING
                  Parameters:
                    loggingLevel:
                      ValueType: CUSTOM
                      Value:
                        Enum: ERROR
                  LastUpdateReason: Updated control parameters to comply with internal requirements
                  Provider: AWS
        '500':
          description: InternalException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalException'
        '401':
          description: InvalidAccessException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidAccessException'
        '400':
          description: InvalidInputException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidInputException'
        '429':
          description: LimitExceededException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LimitExceededException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchGetSecurityControlsRequest'
            example:
              SecurityControlIds:
              - ACM.1
              - APIGateway.1
      tags:
      - Controls
  /securityControls/definitions:
    get:
      operationId: ListSecurityControlDefinitions
      summary: List Security Control Definitions
      description: Lists all of the security controls that apply to a specified standard.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListSecurityControlDefinitionsResponse'
              example:
                SecurityControlDefinitions:
                - SecurityControlId: Azure.App.1
                  Title: Azure Container Apps with managed identity enabled should follow least privilege
                  Description: This control checks whether Azure Container Apps have managed identity enabled. The control
                    fails if the Container App has a system-assigned or user-assigned managed identity enabled.
                  RemediationUrl: https://docs.aws.amazon.com/console/securityhub/Azure.App.1/remediation
                  SeverityRating: MEDIUM
                  CurrentRegionAvailability: AVAILABLE
                  CustomizableProperties: []
                  Provider: Azure
                - SecurityControlId: Azure.App.2
                  Title: Azure Container Apps should not pass Azure SDK credentials as environment variables
                  Description: This control checks whether an Azure Container App passes Azure SDK credentials as plain-text
                    container environment variables. The control fails if any container (including initContainers) defines
                    AZURE_CLIENT_SECRET, AZURE_CLIENT_CERTIFICATE_PASSWORD, or AZURE_PASSWORD as a plain-text environment
                    variable instead of referencing a secret via secretRef.
                  RemediationUrl: https://docs.aws.amazon.com/console/securityhub/Azure.App.2/remediation
                  SeverityRating: CRITICAL
                  CurrentRegionAvailability: AVAILABLE
                  CustomizableProperties: []
                  Provider: Azure
                - SecurityControlId: Azure.App.3
                  Title: Azure Container Apps should not have external ingress enabled
                  Description: This control checks whether Azure Container Apps have external ingress configured. The control
                    fails if the Container App ingress is set to accept traffic from anywhere (external).
                  RemediationUrl: https://docs.aws.amazon.com/console/securityhub/Azure.App.3/remediation
                  SeverityRating: HIGH
                  CurrentRegionAvailability: AVAILABLE
                  CustomizableProperties: []
                  Provider: Azure
                NextToken: U2FsdGVkX1...
        '500':
          description: InternalException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalException'
        '401':
          description: InvalidAccessException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidAccessException'
        '400':
          description: InvalidInputException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidInputException'
        '429':
          description: LimitExceededException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LimitExceededException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListSecurityControlDefinitionsRequest'
            example:
              Providers:
              - Azure
              MaxResults: 3
      tags:
      - Controls
components:
  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: securityhub
  schemas:
    BatchGetSecurityControlsRequest:
      type: object
      properties:
        SecurityControlIds:
          type: array
          items:
            type: string
          description: A list of security controls (identified with SecurityControlId, SecurityControlArn, or a mix of both
            parameters). The security control ID or Amazon Resource Name (ARN) is the same across standards.
      required:
      - SecurityControlIds
    BatchGetSecurityControlsResponse:
      type: object
      properties:
        SecurityControls:
          type: array
          items:
            $ref: '#/components/schemas/SecurityControl'
          description: An array that returns the identifier, Amazon Resource Name (ARN), and other details about a security
            control. The same information is returned whether the request includes SecurityControlId or SecurityControlArn.
        UnprocessedIds:
          type: array
          items:
            $ref: '#/components/schemas/UnprocessedSecurityControl'
          description: A security control (identified with SecurityControlId, SecurityControlArn, or a mix of both parameters)
            for which details cannot be returned.
      required:
      - SecurityControls
    BooleanConfigurationOptions:
      type: object
      properties:
        DefaultValue:
          type: boolean
          description: The Security Hub CSPM default value for a boolean parameter.
    ConfigurationOptions:
      type: object
      properties:
        Integer:
          $ref: '#/components/schemas/IntegerConfigurationOptions'
        IntegerList:
          $ref: '#/components/schemas/IntegerListConfigurationOptions'
        Double:
          $ref: '#/components/schemas/DoubleConfigurationOptions'
        String:
          $ref: '#/components/schemas/StringConfigurationOptions'
        StringList:
          $ref: '#/components/schemas/StringListConfigurationOptions'
        Boolean:
          $ref: '#/components/schemas/BooleanConfigurationOptions'
        Enum:
          $ref: '#/components/schemas/EnumConfigurationOptions'
        EnumList:
          $ref: '#/components/schemas/EnumListConfigurationOptions'
      description: Exactly one member is set.
    DescribeStandardsControlsRequest:
      type: object
      properties:
        StandardsSubscriptionArn:
          type: string
          description: The ARN of a resource that represents your subscription to a supported standard. To get the subscription
            ARNs of the standards you have enabled, use the GetEnabledStandards operation.
        NextToken:
          type: string
          description: The token that is required for pagination. On your first call to the DescribeStandardsControls operation,
            set the value of this parameter to NULL. For subsequent calls to the operation, to continue listing data, set
            the value of this parameter to the value returned from the previous response.
        MaxResults:
          type: integer
          description: The maximum number of security standard controls to return.
      required:
      - StandardsSubscriptionArn
    DescribeStandardsControlsResponse:
      type: object
      properties:
        Controls:
          type: array
          items:
            $ref: '#/components/schemas/StandardsControl'
          description: A list of security standards controls.
        NextToken:
          type: string
          description: The pagination token to use to request the next page of results.
    DoubleConfigurationOptions:
      type: object
      properties:
        DefaultValue:
          type: number
          description: The Security Hub CSPM default value for a control parameter that is a double.
        Min:
          type: number
          description: The minimum valid value for a control parameter that is a double.
        Max:
          type: number
          description: The maximum valid value for a control parameter that is a double.
    EnumConfigurationOptions:
      type: object
      properties:
        DefaultValue:
          type: string
          description: The Security Hub CSPM default value for a control parameter that is an enum.
        AllowedValues:
          type: array
          items:
            type: string
          description: The valid values for a control parameter that is an enum.
    EnumListConfigurationOptions:
      type: object
      properties:
        DefaultValue:
          type: array
          items:
            type: string
          description: The Security Hub CSPM default value for a control parameter that is a list of enums.
        MaxItems:
          type: integer
          description: The maximum number of list items that an enum list control parameter can accept.
        AllowedValues:
          type: array
          items:
            type: string
          description: The valid values for a control parameter that is a list of enums.
    IntegerConfigurationOptions:
      type: object
      properties:
        DefaultValue:
          type: integer
          description: The Security Hub CSPM default value for a control parameter that is an integer.
        Min:
          type: integer
          description: The minimum valid value for a control parameter that is an integer.
        Max:
          type: integer
          description: The maximum valid value for a control parameter that is an integer.
    IntegerListConfigurationOptions:
      type: object
      properties:
        DefaultValue:
          type: array
          items:
            type: integer
          description: The Security Hub CSPM default value for a control parameter that is a list of integers.
        Min:
          type: integer
          description: The minimum valid value for a control parameter that is a list of integers.
        Max:
          type: integer
          description: The maximum valid value for a control parameter that is a list of integers.
        MaxItems:
          type: integer
          description: The maximum number of list items that an interger list control parameter can accept.
    InternalException:
      type: object
      properties:
        Message:
          type: string
        Code:
          type: string
    InvalidAccessException:
      type: object
      properties:
        Message:
          type: string
        Code:
          type: string
    InvalidInputException:
      type: object
      properties:
        Message:
          type: string
        Code:
          type: string
    LimitExceededException:
      type: object
      properties:
        Message:
          type: string
        Code:
          type: string
    ListSecurityControlDefinitionsRequest:
      type: object
      properties:
        StandardsArn:
          type: string
          description: The Amazon Resource Name (ARN) of the standard that you want to view controls for.
        NextToken:
          type: string
          description: Optional pagination parameter.
        MaxResults:
          type: integer
          description: An optional parameter that limits the total results of the API response to the specified number. If
            this parameter isn't provided in the request, the results include the first 25 security controls that apply to
            the specified standard. The results also include a NextToken parameter that you can use in a subsequent API call
            to get the next 25 controls. This repeats until all controls for the standard are returned.
        Providers:
          type: array
          items:
            type: string
            enum:
            - AWS
            - Azure
          description: A list of cloud providers to filter the security control definitions by. For example, specify Azure
            to return only controls that evaluate Azure resources.
    ListSecurityControlDefinitionsResponse:
      type: object
      properties:
        SecurityControlDefinitions:
          type: array
          items:
            $ref: '#/components/schemas/SecurityControlDefinition'
          description: An array of controls that apply to the specified standard.
        NextToken:
          type: string
          description: A pagination parameter that's included in the response only if it was included in the request.
      required:
      - SecurityControlDefinitions
    ParameterConfiguration:
      type: object
      properties:
        ValueType:
          type: string
          enum:
          - DEFAULT
          - CUSTOM
          description: Identifies whether a control parameter uses a custom user-defined value or subscribes to the default
            Security Hub CSPM behavior. When ValueType is set equal to DEFAULT, the default behavior can be a specific Security
            Hub CSPM default value, or the default behavior can be to ignore a specific parameter. When ValueType is set equal
            to DEFAULT, Security Hub CSPM ignores user-provided input for the Value field. When ValueType is set equal to
            CUSTOM, the Value field can't be empty.
        Value:
          $ref: '#/components/schemas/ParameterValue'
      required:
      - ValueType
    ParameterDefinition:
      type: object
      properties:
        Description:
          type: string
          description: Description of a control parameter.
        ConfigurationOptions:
          $ref: '#/components/schemas/ConfigurationOptions'
      required:
      - Description
      - ConfigurationOptions
    ParameterValue:
      type: object
      properties:
        Integer:
          type: integer
          description: A control parameter that is an integer.
        IntegerList:
          type: array
          items:
            type: integer
          description: A control parameter that is a list of integers.
        Double:
          type: number
          description: A control parameter that is a double.
        String:
          type: string
          description: A control parameter that is a string.
        StringList:
          type: array
          items:
            type: string
          description: A control parameter that is a list of strings.
        Boolean:
          type: boolean
          description: A control parameter that is a boolean.
        Enum:
          type: string
          description: A control parameter that is an enum.
        EnumList:
          type: array
          items:
            type: string
          description: A control parameter that is a list of enums.
      description: Exactly one member is set.
    ResourceNotFoundException:
      type: object
      properties:
        Message:
          type: string
        Code:
          type: string
    SecurityControl:
      type: object
      properties:
        SecurityControlId:
          type: string
          description: The unique identifier of a security control across standards. Values for this field typically consist
            of an Amazon Web Services service name and a number, such as APIGateway.3.
        SecurityControlArn:
          type: string
          description: The Amazon Resource Name (ARN) for a security control across standards, such as arn:aws:securityhub:eu-central-1:123456789012:security-control/S3.1.
            This parameter doesn't mention a specific standard.
        Title:
          type: string
          description: The title of a security control.
        Description:
          type: string
          description: The description of a security control across standards. This typically summarizes how Security Hub
            CSPM evaluates the control and the conditions under which it produces a failed finding. This parameter doesn't
            reference a specific standard.
        RemediationUrl:
          type: string
          description: A link to Security Hub CSPM documentation that explains how to remediate a failed finding for a security
            control.
        SeverityRating:
          type: string
          enum:
          - LOW
          - MEDIUM
          - HIGH
          - CRITICAL
          description: The severity of a security control. For more information about how Security Hub CSPM determines control
            severity, see Assigning severity to control findings in the Security Hub CSPM User Guide.
        SecurityControlStatus:
          type: string
          enum:
          - ENABLED
          - DISABLED
          description: The enablement status of a security control in a specific standard.
        UpdateStatus:
          type: string
          enum:
          - READY
          - UPDATING
          description: Identifies whether customizable properties of a security control are reflected in Security Hub CSPM
            findings. A status of READY indicates that Security Hub CSPM uses the current control parameter values when running
            security checks of the control. A status of UPDATING indicates that all security checks might not use the current
            parameter values.
        Parameters:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ParameterConfiguration'
          description: An object that identifies the name of a control parameter, its current value, and whether it has been
            customized.
        LastUpdateReason:
          type: string
          description: The most recent reason for updating the customizable properties of a security control. This differs
            from the UpdateReason field of the BatchUpdateStandardsControlAssociations API, which tracks the reason for updating
            the enablement status of a control. This field accepts alphanumeric characters in addition to white spaces, dashes,
            and underscores.
        Provider:
          type: string
          enum:
          - AWS
          - Azure
          description: The cloud provider whose resources the security control evaluates. For example, AWS or Azure.
      required:
      - SecurityControlId
      - SecurityControlArn
      - Title
      - Description
      - RemediationUrl
      - SeverityRating
      - SecurityControlStatus
    SecurityControlDefinition:
      type: object
      properties:
        SecurityControlId:
          type: string
          description: The unique identifier of a security control across standards. Values for this field typically consist
            of an Amazon Web Services service name and a number (for example, APIGateway.3). This parameter differs from SecurityControlArn,
            which is a unique Amazon Resource Name (ARN) assigned to a control. The ARN references the security control ID
            (for example, arn:aws:securityhub:eu-central-1:123456789012:security-control/APIGateway.3).
        Title:
          type: string
          description: The title of a security control.
        Description:
          type: string
          description: The description of a security control across standards. This typically summarizes how Security Hub
            CSPM evaluates the control and the conditions under which it produces a failed finding. This parameter doesn't
            reference a specific standard.
        RemediationUrl:
          type: string
          description: A link to Security Hub CSPM documentation that explains how to remediate a failed finding for a security
            control.
        SeverityRating:
          type: string
          enum:
          - LOW
          - MEDIUM
          - HIGH
          - CRITICAL
          description: The severity of a security control. For more information about how Security Hub CSPM determines control
            severity, see Assigning severity to control findings in the Security Hub CSPM User Guide.
        CurrentRegionAvailability:
          type: string
          enum:
          - AVAILABLE
          - UNAVAILABLE
          description: Specifies whether a security control is available in the current Amazon Web Services Region.
        CustomizableProperties:
          type: array
          items:
            type: string
            enum:
            - Parameters
          description: Security control properties that you can customize. Currently, only parameter customization is supported
            for select controls. An empty array is returned for controls that don’t support custom properties.
        ParameterDefinitions:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ParameterDefinition'
          description: An object that provides a security control parameter name, description, and the options for customizing
            it. This object is excluded for a control that doesn't support custom parameters.
        Provider:
          type: string
          enum:
          - AWS
          - Azure
          description: The cloud provider whose resources the security control evaluates. For example, AWS or Azure.
      required:
      - SecurityControlId
      - Title
      - Description
      - RemediationUrl
      - SeverityRating
      - CurrentRegionAvailability
    StandardsControl:
      type: object
      properties:
        StandardsControlArn:
          type: string
          description: The ARN of the security standard control.
        ControlStatus:
          type: string
          enum:
          - ENABLED
          - DISABLED
          description: The current status of the security standard control. Indicates whether the control is enabled or disabled.
            Security Hub CSPM does not check against disabled controls.
        DisabledReason:
          type: string
          description: The reason provided for the most recent change in status for the control.
        ControlStatusUpdatedAt:
          type: string
          format: date-time
          description: The date and time that the status of the security standard control was most recently updated.
        ControlId:
          type: string
          description: The identifier of the security standard control.
        Title:
          type: string
          description: The title of the security standard control.
        Description:
          type: string
          description: The longer description of the security standard control. Provides information about what the control
            is checking for.
        RemediationUrl:
          type: string
          description: A link to remediation information for the control in the Security Hub CSPM user documentation.
        SeverityRating:
          type: string
          enum:
          - LOW
          - MEDIUM
          - HIGH
          - CRITICAL
          description: The severity of findings generated from this security standard control. The finding severity is based
            on an assessment of how easy it would be to compromise Amazon Web Services resources if the issue is detected.
        RelatedRequirements:
          type: array
          items:
            type: string
          description: The list of requirements that are related to this control.
    StringConfigurationOptions:
      type: object
      properties:
        DefaultValue:
          type: string
          description: The Security Hub CSPM default value for a control parameter that is a string.
        Re2Expression:
          type: string
          description: An RE2 regular expression that Security Hub CSPM uses to validate a user-provided control parameter
            string.
        ExpressionDescription:
          type: string
          description: The description of the RE2 regular expression.
    StringListConfigurationOptions:
      type: object
      properties:
        DefaultValue:
          type: array
          items:
            type: string
          description: The Security Hub CSPM default value for a control parameter that is a list of strings.
        Re2Expression:
          type: string
          description: An RE2 regular expression that Security Hub CSPM uses to validate a user-provided list of strings for
            a control parameter.
        MaxItems:
          type: integer
          description: The maximum number of list items that a string list control parameter can accept.
        ExpressionDescription:
          type: string
          description: The description of the RE2 regular expression.
    UnprocessedSecurityControl:
      type: object
      properties:
        SecurityControlId:
          type: string
          description: The control (identified with SecurityControlId, SecurityControlArn, or a mix of both parameters) for
            which a response couldn't be returned.
        ErrorCode:
          type: string
          enum:
          - INVALID_INPUT
          - ACCESS_DENIED
          - NOT_FOUND
          - RESOURCE_NOT_FOUND
          - LIMIT_EXCEEDED
          description: The error code for the unprocessed security control. The NOT_FOUND value has been deprecated and replaced
            by the RESOURCE_NOT_FOUND value.
        ErrorReason:
          type: string
          description: The reason why the security control was unprocessed.
      required:
      - SecurityControlId
      - ErrorCode
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/securityhub/service/2018-10-26/securityhub-2018-10-26.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)