Amazon Migration Hub Migration Hub Applications API

The Migration Hub Applications API from Amazon Migration Hub — 2 operation(s) for migration hub applications.

GitHub OpenAPI

Operations 4

POST /environments/{EnvironmentIdentifier}/applications Create Application #
GET /environments/{EnvironmentIdentifier}/applications List Applications #
DELETE /environments/{EnvironmentIdentifier}/applications/{ApplicationIdentifier} Delete Application #
GET /environments/{EnvironmentIdentifier}/applications/{ApplicationIdentifier} Get Application #

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-migration-hub:amazon-migration-hub-applications-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

amazon-migration-hub-applications-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: AWS Migration Hub Applications API
  version: '2017-05-31'
  description: Generated from AWS's published Smithy model for AWS Migration Hub. 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://refactor-spaces.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /environments/{EnvironmentIdentifier}/applications:
    post:
      operationId: CreateApplication
      summary: Create Application
      description: Creates an Amazon Web Services Migration Hub Refactor Spaces application. The account that owns the environment
        also owns the applications created inside the environment, regardless of the account that creates the application.
        Refactor Spaces provisions an Amazon API Gateway, API Gateway VPC link, and Network Load Balancer for the application
        proxy inside your account. In environments created with a CreateEnvironment:NetworkFabricType of NONE you need to
        configure VPC to VPC connectivity between your service VPC and the application proxy VPC to route traffic through
        the application proxy to a service with a private URL endpoint. For more information, see Create an application in
        the Refactor Spaces User Guide.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateApplicationResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefactorSpacesAccessDeniedException'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictException'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '402':
          description: ServiceQuotaExceededException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceQuotaExceededException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefactorSpacesThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateApplicationRequest'
      tags:
      - Applications
    get:
      operationId: ListApplications
      summary: List Applications
      description: Lists all the Amazon Web Services Migration Hub Refactor Spaces applications within an environment.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListApplicationsResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefactorSpacesAccessDeniedException'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictException'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '402':
          description: ServiceQuotaExceededException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceQuotaExceededException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefactorSpacesThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListApplicationsRequest'
      tags:
      - Applications
  /environments/{EnvironmentIdentifier}/applications/{ApplicationIdentifier}:
    delete:
      operationId: DeleteApplication
      summary: Delete Application
      description: Deletes an Amazon Web Services Migration Hub Refactor Spaces application. Before you can delete an application,
        you must first delete any services or routes within the application.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteApplicationResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefactorSpacesAccessDeniedException'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictException'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefactorSpacesThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteApplicationRequest'
      tags:
      - Applications
    get:
      operationId: GetApplication
      summary: Get Application
      description: Gets an Amazon Web Services Migration Hub Refactor Spaces application.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApplicationResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefactorSpacesAccessDeniedException'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefactorSpacesThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetApplicationRequest'
      tags:
      - Applications
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: refactor-spaces
  schemas:
    ApiGatewayProxyConfig:
      type: object
      properties:
        ProxyUrl:
          type: string
          description: The endpoint URL of the API Gateway proxy.
        ApiGatewayId:
          type: string
          description: The resource ID of the API Gateway for the proxy.
        VpcLinkId:
          type: string
          description: The VpcLink ID of the API Gateway proxy.
        NlbArn:
          type: string
          description: The Amazon Resource Name (ARN) of the Network Load Balancer configured by the API Gateway proxy.
        NlbName:
          type: string
          description: The name of the Network Load Balancer that is configured by the API Gateway proxy.
        EndpointType:
          type: string
          description: The type of API Gateway endpoint created.
        StageName:
          type: string
          description: The name of the API Gateway stage. The name defaults to prod.
    ApiGatewayProxyInput:
      type: object
      properties:
        EndpointType:
          type: string
          description: The type of endpoint to use for the API Gateway proxy. If no value is specified in the request, the
            value is set to REGIONAL by default. If the value is set to PRIVATE in the request, this creates a private API
            endpoint that is isolated from the public internet. The private endpoint can only be accessed by using Amazon
            Virtual Private Cloud (Amazon VPC) interface endpoints for the Amazon API Gateway that has been granted access.
            For more information about creating a private connection with Refactor Spaces and interface endpoint (Amazon Web
            Services PrivateLink) availability, see Access Refacto
        StageName:
          type: string
          description: The name of the API Gateway stage. The name defaults to prod.
    ApiGatewayProxySummary:
      type: object
      properties:
        ProxyUrl:
          type: string
          description: The endpoint URL of the API Gateway proxy.
        ApiGatewayId:
          type: string
          description: The resource ID of the API Gateway for the proxy.
        VpcLinkId:
          type: string
          description: The VpcLink ID of the API Gateway proxy.
        NlbArn:
          type: string
          description: The Amazon Resource Name (ARN) of the Network Load Balancer configured by the API Gateway proxy.
        NlbName:
          type: string
          description: The name of the Network Load Balancer that is configured by the API Gateway proxy.
        EndpointType:
          type: string
          description: The type of API Gateway endpoint created.
        StageName:
          type: string
          description: The name of the API Gateway stage. The name defaults to prod.
    ApplicationSummary:
      type: object
      properties:
        Name:
          type: string
          description: The name of the application.
        Arn:
          type: string
          description: The Amazon Resource Name (ARN) of the application.
        OwnerAccountId:
          type: string
          description: The Amazon Web Services account ID of the application owner (which is always the same as the environment
            owner account ID).
        CreatedByAccountId:
          type: string
          description: The Amazon Web Services account ID of the application creator.
        ApplicationId:
          type: string
          description: The unique identifier of the application.
        EnvironmentId:
          type: string
          description: The unique identifier of the environment.
        VpcId:
          type: string
          description: The ID of the virtual private cloud (VPC).
        ProxyType:
          type: string
          description: The proxy type of the proxy created within the application.
        ApiGatewayProxy:
          $ref: '#/components/schemas/ApiGatewayProxySummary'
        State:
          type: string
          description: The current state of the application.
        Tags:
          type: object
          additionalProperties:
            type: string
          description: The tags assigned to the application.
        Error:
          $ref: '#/components/schemas/ErrorResponse'
        LastUpdatedTime:
          type: string
          format: date-time
          description: A timestamp that indicates when the application was last updated.
        CreatedTime:
          type: string
          format: date-time
          description: A timestamp that indicates when the application is created.
    ConflictException:
      type: object
      properties:
        Message:
          type: string
        ResourceId:
          type: string
          description: The ID of the resource.
        ResourceType:
          type: string
          description: The type of resource.
      required:
      - Message
      - ResourceId
      - ResourceType
    CreateApplicationRequest:
      type: object
      properties:
        Name:
          type: string
          description: The name to use for the application.
        EnvironmentIdentifier:
          type: string
          description: The unique identifier of the environment.
        VpcId:
          type: string
          description: The ID of the virtual private cloud (VPC).
        ProxyType:
          type: string
          description: The proxy type of the proxy created within the application.
        ApiGatewayProxy:
          $ref: '#/components/schemas/ApiGatewayProxyInput'
        Tags:
          type: object
          additionalProperties:
            type: string
          description: The tags to assign to the application. A tag is a label that you assign to an Amazon Web Services resource.
            Each tag consists of a key-value pair.
        ClientToken:
          type: string
          description: A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
      required:
      - Name
      - EnvironmentIdentifier
      - VpcId
      - ProxyType
    CreateApplicationResponse:
      type: object
      properties:
        Name:
          type: string
          description: The name of the application.
        Arn:
          type: string
          description: The Amazon Resource Name (ARN) of the application. The format for this ARN is arn:aws:refactor-spaces:region:account-id:resource-type/resource-id
            . For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.
        OwnerAccountId:
          type: string
          description: The Amazon Web Services account ID of the application owner (which is always the same as the environment
            owner account ID).
        CreatedByAccountId:
          type: string
          description: The Amazon Web Services account ID of application creator.
        ApplicationId:
          type: string
          description: The unique identifier of the application.
        EnvironmentId:
          type: string
          description: The ID of the environment in which the application is created.
        VpcId:
          type: string
          description: The ID of the Amazon VPC.
        ProxyType:
          type: string
          description: The proxy type of the proxy created within the application.
        ApiGatewayProxy:
          $ref: '#/components/schemas/ApiGatewayProxyInput'
        State:
          type: string
          description: The current state of the application.
        Tags:
          type: object
          additionalProperties:
            type: string
          description: The tags assigned to the application. A tag is a label that you assign to an Amazon Web Services resource.
            Each tag consists of a key-value pair.
        LastUpdatedTime:
          type: string
          format: date-time
          description: A timestamp that indicates when the application was last updated.
        CreatedTime:
          type: string
          format: date-time
          description: A timestamp that indicates when the application is created.
    DeleteApplicationRequest:
      type: object
      properties:
        EnvironmentIdentifier:
          type: string
          description: The ID of the environment.
        ApplicationIdentifier:
          type: string
          description: The ID of the application.
      required:
      - EnvironmentIdentifier
      - ApplicationIdentifier
    DeleteApplicationResponse:
      type: object
      properties:
        Name:
          type: string
          description: The name of the application.
        Arn:
          type: string
          description: The Amazon Resource Name (ARN) of the application.
        ApplicationId:
          type: string
          description: The ID of the application.
        EnvironmentId:
          type: string
          description: The unique identifier of the application’s environment.
        State:
          type: string
          description: The current state of the application.
        LastUpdatedTime:
          type: string
          format: date-time
          description: A timestamp that indicates when the environment was last updated.
    ErrorResponse:
      type: object
      properties:
        Code:
          type: string
          description: The error code associated with the error.
        Message:
          type: string
          description: The message associated with the error.
        AccountId:
          type: string
          description: The Amazon Web Services account ID of the resource owner.
        ResourceIdentifier:
          type: string
          description: The ID of the resource.
        ResourceType:
          type: string
          description: The type of resource.
        AdditionalDetails:
          type: object
          additionalProperties:
            type: string
          description: Additional details about the error.
    GetApplicationRequest:
      type: object
      properties:
        EnvironmentIdentifier:
          type: string
          description: The ID of the environment.
        ApplicationIdentifier:
          type: string
          description: The ID of the application.
      required:
      - EnvironmentIdentifier
      - ApplicationIdentifier
    GetApplicationResponse:
      type: object
      properties:
        Name:
          type: string
          description: The name of the application.
        Arn:
          type: string
          description: The Amazon Resource Name (ARN) of the application.
        OwnerAccountId:
          type: string
          description: The Amazon Web Services account ID of the application owner (which is always the same as the environment
            owner account ID).
        CreatedByAccountId:
          type: string
          description: The Amazon Web Services account ID of the application creator.
        ApplicationId:
          type: string
          description: The unique identifier of the application.
        EnvironmentId:
          type: string
          description: The unique identifier of the environment.
        VpcId:
          type: string
          description: The ID of the virtual private cloud (VPC).
        ProxyType:
          type: string
          description: The proxy type of the proxy created within the application.
        ApiGatewayProxy:
          $ref: '#/components/schemas/ApiGatewayProxyConfig'
        State:
          type: string
          description: The current state of the application.
        Tags:
          type: object
          additionalProperties:
            type: string
          description: The tags assigned to the application. A tag is a label that you assign to an Amazon Web Services resource.
            Each tag consists of a key-value pair.
        Error:
          $ref: '#/components/schemas/ErrorResponse'
        LastUpdatedTime:
          type: string
          format: date-time
          description: A timestamp that indicates when the application was last updated.
        CreatedTime:
          type: string
          format: date-time
          description: A timestamp that indicates when the application is created.
    InternalServerException:
      type: object
      properties:
        Message:
          type: string
      required:
      - Message
    ListApplicationsRequest:
      type: object
      properties:
        EnvironmentIdentifier:
          type: string
          description: The ID of the environment.
        NextToken:
          type: string
          description: The token for the next page of results.
        MaxResults:
          type: integer
          description: The maximum number of results to return with a single call. To retrieve the remaining results, make
            another call with the returned nextToken value.
      required:
      - EnvironmentIdentifier
    ListApplicationsResponse:
      type: object
      properties:
        ApplicationSummaryList:
          type: array
          items:
            $ref: '#/components/schemas/ApplicationSummary'
          description: The list of ApplicationSummary objects.
        NextToken:
          type: string
          description: The token for the next page of results.
    RefactorSpacesAccessDeniedException:
      type: object
      properties:
        Message:
          type: string
      required:
      - Message
    RefactorSpacesThrottlingException:
      type: object
      properties:
        Message:
          type: string
        QuotaCode:
          type: string
          description: Service quota requirement to identify originating quota. Reached throttling quota exception.
        ServiceCode:
          type: string
          description: Service quota requirement to identify originating service. Reached throttling quota exception service
            code.
        RetryAfterSeconds:
          type: integer
          description: The number of seconds to wait before retrying.
      required:
      - Message
    ResourceNotFoundException:
      type: object
      properties:
        Message:
          type: string
        ResourceId:
          type: string
          description: The ID of the resource.
        ResourceType:
          type: string
          description: The type of resource.
      required:
      - Message
      - ResourceId
      - ResourceType
    ServiceQuotaExceededException:
      type: object
      properties:
        Message:
          type: string
        ResourceId:
          type: string
          description: The ID of the resource.
        ResourceType:
          type: string
          description: The type of resource.
        QuotaCode:
          type: string
          description: Service quota requirement to identify originating quota. Reached throttling quota exception.
        ServiceCode:
          type: string
          description: Service quota requirement to identify originating service. Reached throttling quota exception service
            code.
      required:
      - Message
      - ResourceId
      - ResourceType
      - ServiceCode
    ValidationException:
      type: object
      properties:
        Message:
          type: string
      required:
      - Message
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/migration-hub-refactor-spaces/service/2021-10-26/migration-hub-refactor-spaces-2021-10-26.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)