Amazon Service Catalog Service Catalog Applications API

The Service Catalog Applications API from Amazon Service Catalog — 2 operation(s) for service catalog applications.

GitHub OpenAPI

Operations 5

POST /applications Create Application #
GET /applications List Applications #
DELETE /applications/{application} Delete Application #
GET /applications/{application} Get Application #
PATCH /applications/{application} Update 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-service-catalog:amazon-service-catalog-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-service-catalog-applications-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: AWS Service Catalog Applications API
  version: '2015-12-10'
  description: Generated from AWS's published Smithy model for AWS Service Catalog. 5 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://servicecatalog-appregistry.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /applications:
    post:
      operationId: CreateApplication
      summary: Create Application
      description: Creates a new application that is the top-level node in a hierarchy of related cloud resource abstractions.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateApplicationResponse'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictException'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '402':
          description: ServiceQuotaExceededException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceQuotaExceededException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '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: Retrieves a list of all of your applications. Results are paginated.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListApplicationsResponse'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListApplicationsRequest'
      tags:
      - Applications
  /applications/{application}:
    delete:
      operationId: DeleteApplication
      summary: Delete Application
      description: Deletes an application that is specified either by its application ID, name, or ARN. All associated attribute
        groups and resources must be disassociated from it before deleting an application.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteApplicationResponse'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServicecatalogAppregistryResourceNotFoundException'
        '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: Retrieves metadata information about one of your applications. The application can be specified by its
        ARN, ID, or name (which is unique within one account in one region at a given point in time). Specify by ARN or ID
        in automated workflows if you want to make sure that the exact same application is returned or a ResourceNotFoundException
        is thrown, avoiding the ABA addressing problem.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApplicationResponse'
        '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/ServicecatalogAppregistryResourceNotFoundException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetApplicationRequest'
      tags:
      - Applications
    patch:
      operationId: UpdateApplication
      summary: Update Application
      description: Updates an existing application with new attributes.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateApplicationResponse'
        '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/ServicecatalogAppregistryResourceNotFoundException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateApplicationRequest'
      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: servicecatalog
  schemas:
    Application:
      type: object
      properties:
        id:
          type: string
          description: The identifier of the application.
        arn:
          type: string
          description: The Amazon resource name (ARN) that specifies the application across services.
        name:
          type: string
          description: The name of the application. The name must be unique in the region in which you are creating the application.
        description:
          type: string
          description: The description of the application.
        creationTime:
          type: string
          format: date-time
          description: The ISO-8601 formatted timestamp of the moment when the application was created.
        lastUpdateTime:
          type: string
          format: date-time
          description: The ISO-8601 formatted timestamp of the moment when the application was last updated.
        tags:
          type: object
          additionalProperties:
            type: string
          description: Key-value pairs you can use to associate with the application.
        applicationTag:
          type: object
          additionalProperties:
            type: string
          description: A key-value pair that identifies an associated resource.
    ApplicationSummary:
      type: object
      properties:
        id:
          type: string
          description: The identifier of the application.
        arn:
          type: string
          description: The Amazon resource name (ARN) that specifies the application across services.
        name:
          type: string
          description: The name of the application. The name must be unique in the region in which you are creating the application.
        description:
          type: string
          description: The description of the application.
        creationTime:
          type: string
          format: date-time
          description: The ISO-8601 formatted timestamp of the moment when the application was created.
        lastUpdateTime:
          type: string
          format: date-time
          description: The ISO-8601 formatted timestamp of the moment when the application was last updated.
    ConflictException:
      type: object
      properties:
        message:
          type: string
    CreateApplicationRequest:
      type: object
      properties:
        name:
          type: string
          description: The name of the application. The name must be unique in the region in which you are creating the application.
        description:
          type: string
          description: The description of the application.
        tags:
          type: object
          additionalProperties:
            type: string
          description: Key-value pairs you can use to associate with the application.
        clientToken:
          type: string
          description: A unique identifier that you provide to ensure idempotency. If you retry a request that completed successfully
            using the same client token and the same parameters, the retry succeeds without performing any further actions.
            If you retry a successful request using the same client token, but one or more of the parameters are different,
            the retry fails.
      required:
      - name
      - clientToken
    CreateApplicationResponse:
      type: object
      properties:
        application:
          $ref: '#/components/schemas/Application'
    DeleteApplicationRequest:
      type: object
      properties:
        application:
          type: string
          description: The name, ID, or ARN of the application.
      required:
      - application
    DeleteApplicationResponse:
      type: object
      properties:
        application:
          $ref: '#/components/schemas/ApplicationSummary'
    GetApplicationRequest:
      type: object
      properties:
        application:
          type: string
          description: The name, ID, or ARN of the application.
      required:
      - application
    GetApplicationResponse:
      type: object
      properties:
        id:
          type: string
          description: The identifier of the application.
        arn:
          type: string
          description: The Amazon resource name (ARN) that specifies the application across services.
        name:
          type: string
          description: The name of the application. The name must be unique in the region in which you are creating the application.
        description:
          type: string
          description: The description of the application.
        creationTime:
          type: string
          format: date-time
          description: The ISO-8601 formatted timestamp of the moment when the application was created.
        lastUpdateTime:
          type: string
          format: date-time
          description: The ISO-8601 formatted timestamp of the moment when the application was last updated.
        associatedResourceCount:
          type: integer
          description: The number of top-level resources that were registered as part of this application.
        tags:
          type: object
          additionalProperties:
            type: string
          description: Key-value pairs associated with the application.
        integrations:
          $ref: '#/components/schemas/Integrations'
        applicationTag:
          type: object
          additionalProperties:
            type: string
          description: A key-value pair that identifies an associated resource.
    Integrations:
      type: object
      properties:
        resourceGroup:
          $ref: '#/components/schemas/ResourceGroup'
        applicationTagResourceGroup:
          $ref: '#/components/schemas/ResourceGroup'
    InternalServerException:
      type: object
      properties:
        message:
          type: string
    ListApplicationsRequest:
      type: object
      properties:
        nextToken:
          type: string
          description: The token to use to get the next page of results after a previous API call.
        maxResults:
          type: integer
          description: The upper bound of the number of results to return (cannot exceed 25). If this parameter is omitted,
            it defaults to 25. This value is optional.
    ListApplicationsResponse:
      type: object
      properties:
        applications:
          type: array
          items:
            $ref: '#/components/schemas/ApplicationSummary'
          description: This list of applications.
        nextToken:
          type: string
          description: The token to use to get the next page of results after a previous API call.
    ResourceGroup:
      type: object
      properties:
        state:
          type: string
          enum:
          - CREATING
          - CREATE_COMPLETE
          - CREATE_FAILED
          - UPDATING
          - UPDATE_COMPLETE
          - UPDATE_FAILED
          description: 'The state of the propagation process for the resource group. The states includes: CREATING if the
            resource group is in the process of being created. CREATE_COMPLETE if the resource group was created successfully.
            CREATE_FAILED if the resource group failed to be created. UPDATING if the resource group is in the process of
            being updated. UPDATE_COMPLETE if the resource group updated successfully. UPDATE_FAILED if the resource group
            could not update successfully.'
        arn:
          type: string
          description: The Amazon resource name (ARN) of the resource group.
        errorMessage:
          type: string
          description: The error message that generates when the propagation process for the resource group fails.
    ServiceQuotaExceededException:
      type: object
      properties:
        message:
          type: string
    ServicecatalogAppregistryResourceNotFoundException:
      type: object
      properties:
        message:
          type: string
    ThrottlingException:
      type: object
      properties:
        message:
          type: string
          description: A message associated with the Throttling exception.
        serviceCode:
          type: string
          description: The originating service code.
      required:
      - message
    UpdateApplicationRequest:
      type: object
      properties:
        application:
          type: string
          description: The name, ID, or ARN of the application that will be updated.
        name:
          type: string
          description: 'Deprecated: The new name of the application. The name must be unique in the region in which you are
            updating the application. Please do not use this field as we have stopped supporting name updates.'
        description:
          type: string
          description: The new description of the application.
      required:
      - application
    UpdateApplicationResponse:
      type: object
      properties:
        application:
          $ref: '#/components/schemas/Application'
    ValidationException:
      type: object
      properties:
        message:
          type: string
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/service-catalog-appregistry/service/2020-06-24/service-catalog-appregistry-2020-06-24.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)