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-resilience-hub:amazon-resilience-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: 3.1.0
info:
title: AWS Resilience Hub Applications API
version: '2020-04-30'
description: Generated from AWS's published Smithy model for AWS Resilience Hub. 6 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://resiliencehub.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
paths:
/create-app:
post:
operationId: CreateApp
summary: Create App
description: Creates an Resilience Hub application. An Resilience Hub application is a collection of Amazon Web Services
resources structured to prevent and recover Amazon Web Services application disruptions. To describe a Resilience
Hub application, you provide an application name, resources from one or more CloudFormation stacks, Resource Groups,
Terraform state files, AppRegistry applications, and an appropriate resiliency policy. In addition, you can also add
resources that are located on Amazon Elastic Kubernetes Service (Amazon EKS) clusters as optional resources. For more
information about the number of resources supported per application, see Service quotas. After you create an Resilience
Hub application, you publish it so that you can run a resiliency assessment on it. You can then use recommendations
from the assessment to improve resiliency by running another assessment, comparing results, and then iterating the
process until you achieve your goals for recovery time objective (RTO) and recovery point objective (RPO).
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAppResponse'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'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/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAppRequest'
tags:
- Applications
/delete-app:
post:
operationId: DeleteApp
summary: Delete App
description: Deletes an Resilience Hub application. This is a destructive action that can't be undone.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteAppResponse'
'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/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteAppRequest'
tags:
- Applications
/describe-app:
post:
operationId: DescribeApp
summary: Describe App
description: Describes an Resilience Hub application.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DescribeAppResponse'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'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/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DescribeAppRequest'
tags:
- Applications
/list-apps:
get:
operationId: ListApps
summary: List Apps
description: 'Lists your Resilience Hub applications. You can filter applications using only one filter at a time or
without using any filter. If you try to filter applications using multiple filters, you will get the following error:
An error occurred (ValidationException) when calling the ListApps operation: Only one filter is supported for this
operation.'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListAppsResponse'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'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/ListAppsRequest'
tags:
- Applications
/list-app-versions:
post:
operationId: ListAppVersions
summary: List App Versions
description: Lists the different versions for the Resilience Hub applications.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListAppVersionsResponse'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListAppVersionsRequest'
tags:
- Applications
/publish-app-version:
post:
operationId: PublishAppVersion
summary: Publish App Version
description: Publishes a new version of a specific Resilience Hub application.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/PublishAppVersionResponse'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'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/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PublishAppVersionRequest'
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: resiliencehub
schemas:
AccessDeniedException:
type: object
properties:
message:
type: string
App:
type: object
properties:
appArn:
type: string
description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.'
name:
type: string
description: Name for the application.
description:
type: string
description: Optional description for an application.
policyArn:
type: string
description: 'Amazon Resource Name (ARN) of the resiliency policy. The format for this ARN is: arn:partition:resiliencehub:region:account:resiliency-policy/policy-id.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.'
creationTime:
type: string
format: date-time
description: Date and time when the application was created.
status:
type: string
enum:
- Active
- Deleting
description: Status of the application.
complianceStatus:
type: string
enum:
- PolicyBreached
- PolicyMet
- NotAssessed
- ChangesDetected
- NotApplicable
- MissingPolicy
description: Current status of compliance for the resiliency policy.
lastAppComplianceEvaluationTime:
type: string
format: date-time
description: Date and time the most recent compliance evaluation.
resiliencyScore:
type: number
description: Current resiliency score for the application.
lastResiliencyScoreEvaluationTime:
type: string
format: date-time
description: Date and time the most recent resiliency score evaluation.
tags:
type: object
additionalProperties:
type: string
description: Tags assigned to the resource. A tag is a label that you assign to an Amazon Web Services resource.
Each tag consists of a key/value pair.
assessmentSchedule:
type: string
enum:
- Disabled
- Daily
description: Assessment execution schedule with 'Daily' or 'Disabled' values.
permissionModel:
$ref: '#/components/schemas/PermissionModel'
eventSubscriptions:
type: array
items:
$ref: '#/components/schemas/EventSubscription'
description: The list of events you would like to subscribe and get notification for. Currently, Resilience Hub
supports notifications only for Drift detected and Scheduled assessment failure events.
driftStatus:
type: string
enum:
- NotChecked
- NotDetected
- Detected
description: Indicates if compliance drifts (deviations) were detected while running an assessment for your application.
lastDriftEvaluationTime:
type: string
format: date-time
description: Indicates the last time that a drift was evaluated.
rtoInSecs:
type: integer
description: Recovery Time Objective (RTO) in seconds.
rpoInSecs:
type: integer
description: Recovery Point Objective (RPO) in seconds.
awsApplicationArn:
type: string
description: Amazon Resource Name (ARN) of Resource Groups group that is integrated with an AppRegistry application.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.
required:
- appArn
- name
- creationTime
AppSummary:
type: object
properties:
appArn:
type: string
description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.'
name:
type: string
description: The name of the application.
description:
type: string
description: The optional description for an app.
creationTime:
type: string
format: date-time
description: Date and time when the app was created.
complianceStatus:
type: string
enum:
- PolicyBreached
- PolicyMet
- NotAssessed
- ChangesDetected
- NotApplicable
- MissingPolicy
description: The current status of compliance for the resiliency policy.
resiliencyScore:
type: number
description: The current resiliency score for the application.
assessmentSchedule:
type: string
enum:
- Disabled
- Daily
description: Assessment execution schedule with 'Daily' or 'Disabled' values.
status:
type: string
enum:
- Active
- Deleting
description: Status of the application.
driftStatus:
type: string
enum:
- NotChecked
- NotDetected
- Detected
description: Indicates if compliance drifts (deviations) were detected while running an assessment for your application.
lastAppComplianceEvaluationTime:
type: string
format: date-time
description: Date and time of the most recent compliance evaluation.
rtoInSecs:
type: integer
description: Recovery Time Objective (RTO) in seconds.
rpoInSecs:
type: integer
description: Recovery Point Objective (RPO) in seconds.
awsApplicationArn:
type: string
description: Amazon Resource Name (ARN) of Resource Groups group that is integrated with an AppRegistry application.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.
required:
- appArn
- name
- creationTime
AppVersionSummary:
type: object
properties:
appVersion:
type: string
description: Version of an application.
identifier:
type: integer
description: Identifier of the application version.
creationTime:
type: string
format: date-time
description: Creation time of the application version.
versionName:
type: string
description: Name of the application version.
required:
- appVersion
ConflictException:
type: object
properties:
message:
type: string
resourceId:
type: string
description: The identifier of the resource that the exception applies to.
resourceType:
type: string
description: The type of the resource that the exception applies to.
CreateAppRequest:
type: object
properties:
name:
type: string
description: Name of the application.
description:
type: string
description: The optional description for an app.
policyArn:
type: string
description: 'Amazon Resource Name (ARN) of the resiliency policy. The format for this ARN is: arn:partition:resiliencehub:region:account:resiliency-policy/policy-id.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.'
tags:
type: object
additionalProperties:
type: string
description: Tags assigned to the resource. 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: Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII
characters. You should not reuse the same client token for other API requests.
assessmentSchedule:
type: string
enum:
- Disabled
- Daily
description: Assessment execution schedule with 'Daily' or 'Disabled' values.
permissionModel:
$ref: '#/components/schemas/PermissionModel'
eventSubscriptions:
type: array
items:
$ref: '#/components/schemas/EventSubscription'
description: The list of events you would like to subscribe and get notification for. Currently, Resilience Hub
supports only Drift detected and Scheduled assessment failure events notification.
awsApplicationArn:
type: string
description: Amazon Resource Name (ARN) of Resource Groups group that is integrated with an AppRegistry application.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.
required:
- name
CreateAppResponse:
type: object
properties:
app:
$ref: '#/components/schemas/App'
required:
- app
DeleteAppRequest:
type: object
properties:
appArn:
type: string
description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.'
forceDelete:
type: boolean
description: A boolean option to force the deletion of an Resilience Hub application.
clientToken:
type: string
description: Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII
characters. You should not reuse the same client token for other API requests.
required:
- appArn
DeleteAppResponse:
type: object
properties:
appArn:
type: string
description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.'
required:
- appArn
DescribeAppRequest:
type: object
properties:
appArn:
type: string
description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.'
required:
- appArn
DescribeAppResponse:
type: object
properties:
app:
$ref: '#/components/schemas/App'
required:
- app
EventSubscription:
type: object
properties:
name:
type: string
description: Unique name to identify an event subscription.
eventType:
type: string
enum:
- ScheduledAssessmentFailure
- DriftDetected
description: The type of event you would like to subscribe and get notification for. Currently, Resilience Hub supports
notifications only for Drift detected (DriftDetected) and Scheduled assessment failure (ScheduledAssessmentFailure)
events.
snsTopicArn:
type: string
description: 'Amazon Resource Name (ARN) of the Amazon Simple Notification Service topic. The format for this ARN
is: arn:partition:sns:region:account:topic-name. For more information about ARNs, see Amazon Resource Names (ARNs)
in the Amazon Web Services General Reference guide.'
required:
- name
- eventType
InternalServerException:
type: object
properties:
message:
type: string
ListAppVersionsRequest:
type: object
properties:
appArn:
type: string
description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.'
nextToken:
type: string
description: Null, or the token from a previous call to get the next set of results.
maxResults:
type: integer
description: Maximum number of results to include in the response. If more results exist than the specified MaxResults
value, a token is included in the response so that the remaining results can be retrieved.
startTime:
type: string
format: date-time
description: Lower limit of the time range to filter the application versions.
endTime:
type: string
format: date-time
description: Upper limit of the time range to filter the application versions.
required:
- appArn
ListAppVersionsResponse:
type: object
properties:
appVersions:
type: array
items:
$ref: '#/components/schemas/AppVersionSummary'
description: The version of the application.
nextToken:
type: string
description: Token for the next set of results, or null if there are no more results.
required:
- appVersions
ListAppsRequest:
type: object
properties:
nextToken:
type: string
description: Null, or the token from a previous call to get the next set of results.
maxResults:
type: integer
description: Maximum number of results to include in the response. If more results exist than the specified MaxResults
value, a token is included in the response so that the remaining results can be retrieved.
name:
type: string
description: The name for the one of the listed applications.
appArn:
type: string
description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.'
fromLastAssessmentTime:
type: string
format: date-time
description: Lower limit of the range that is used to filter applications based on their last assessment times.
toLastAssessmentTime:
type: string
format: date-time
description: Upper limit of the range that is used to filter the applications based on their last assessment times.
reverseOrder:
type: boolean
description: The application list is sorted based on the values of lastAppComplianceEvaluationTime field. By default,
application list is sorted in ascending order. To sort the application list in descending order, set this field
to True.
awsApplicationArn:
type: string
description: Amazon Resource Name (ARN) of Resource Groups group that is integrated with an AppRegistry application.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.
ListAppsResponse:
type: object
properties:
appSummaries:
type: array
items:
$ref: '#/components/schemas/AppSummary'
description: Summaries for the Resilience Hub application.
nextToken:
type: string
description: Token for the next set of results, or null if there are no more results.
required:
- appSummaries
PermissionModel:
type: object
properties:
type:
type: string
enum:
- LegacyIAMUser
- RoleBased
description: Defines how Resilience Hub scans your resources. It can scan for the resources by using a pre-existing
role in your Amazon Web Services account, or by using the credentials of the current IAM user.
invokerRoleName:
type: string
description: Existing Amazon Web Services IAM role name in the primary Amazon Web Services account that will be
assumed by Resilience Hub Service Principle to obtain a read-only access to your application resources while running
an assessment. If your IAM role includes a path, you must include the path in the invokerRoleName parameter. For
example, if your IAM role's ARN is arn:aws:iam:123456789012:role/my-path/role-name, you should pass my-path/role-name.
You must have iam:passRole permission for this role while creating or updating the application. Currently, invokerRoleName
accepts only [A-Za-z0-9_+=,.@
crossAccountRoleArns:
type: array
items:
type: string
description: Defines a list of role Amazon Resource Names (ARNs) to be used in other accounts. These ARNs are used
for querying purposes while importing resources and assessing your application. These ARNs are required only when
your resources are in other accounts and you have different role name in these accounts. Else, the invoker role
name will be used in the other accounts. These roles must have a trust policy with iam:AssumeRole permission to
the invoker role in the primary account.
required:
- type
PublishAppVersionRequest:
type: object
properties:
appArn:
type: string
description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.'
versionName:
type: string
description: Name of the application version.
required:
- appArn
PublishAppVersionResponse:
type: object
properties:
appArn:
type: string
description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
guide.'
appVersion:
type: string
description: The version of the application.
identifier:
type: integer
description: Identifier of the application version.
versionName:
type: string
description: Name of the application version.
required:
- appArn
ResourceNotFoundException:
type: object
properties:
message:
type: string
resourceId:
type: string
description: The identifier of the resource that the exception applies to.
resourceType:
type: string
description: The type of the resource that the exception applies to.
ServiceQuotaExceededException:
type: object
properties:
message:
type: string
ThrottlingException:
type: object
properties:
message:
type: string
retryAfterSeconds:
type: integer
description: The number of seconds to wait before retrying the operation.
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/resiliencehub/service/2020-04-30/resiliencehub-2020-04-30.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)