How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
APIs.io Engineering Platform

APIs.io Engineering Platform Restapis API

The Restapis API from APIs.io Engineering Platform — 30 operation(s) for restapis.

Documentation Provider Profile APIs.io OpenAPI GitHub

APIs.io Engineering Platform Restapis API is one of 471 APIs that APIs.io Engineering Platform publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include REST APIs. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 75 operations across 30 paths, and defines 91 schemas. It is described by OpenAPI 3.2.0, at version 2015-07-09.

Requests are made against 4 base URLs: http://apigateway.{region}.amazonaws.com, https://apigateway.{region}.amazonaws.com, http://apigateway.{region}.amazonaws.com.cn, https://apigateway.{region}.amazonaws.com.cn.

75 operations 30 paths 91 schemas 16 DELETE27 GET14 PATCH11 POST7 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2015-07-09
Base URL
https://{bucketname}.s3.amazonaws.com
Authentication
API Key
Contact
Mike Ralphson
License
Apache 2.0 License
Terms of Service
View terms
Resource Areas
1

Authentication & Security 1

APIs.io Engineering Platform Restapis API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 75

Across 30 paths, the API surfaces 75 operations — 16 DELETE, 27 GET, 14 PATCH, 11 POST, 7 PUT. Each is listed below with its method, path, parameters, and response codes.

Restapis 75
POST
/restapis/{restapi_id}/authorizers
Adds a new Authorizer resource to an existing RestApi resource.
CreateAuthorizer 8 params body → 201480481482483484485
GET
/restapis/{restapi_id}/authorizers
Describe an existing Authorizers resource.
GetAuthorizers 10 params → 200480481482483
POST
/restapis/{restapi_id}/deployments
Creates a Deployment resource, which makes a specified RestApi callable over the internet.
CreateDeployment 8 params body → 201480481482483484485486
GET
/restapis/{restapi_id}/deployments
Gets information about a Deployments collection.
GetDeployments 10 params → 200480481482483484
POST
/restapis/{restapi_id}/documentation/parts
Creates a documentation part.
CreateDocumentationPart 8 params body → 201480481482483484485
GET
/restapis/{restapi_id}/documentation/parts
Gets documentation parts.
GetDocumentationParts 14 params → 200480481482483
PUT
/restapis/{restapi_id}/documentation/parts
Imports documentation parts
ImportDocumentationParts 10 params body → 200480481482483484485
POST
/restapis/{restapi_id}/documentation/versions
Creates a documentation version
CreateDocumentationVersion 8 params body → 201480481482483484485
GET
/restapis/{restapi_id}/documentation/versions
Gets documentation versions.
GetDocumentationVersions 10 params → 200480481482483
POST
/restapis/{restapi_id}/models
Adds a new Model resource to an existing RestApi resource.
CreateModel 8 params body → 201480481482483484485
GET
/restapis/{restapi_id}/models
Describes existing Models defined for a RestApi resource.
GetModels 10 params → 200480481482483
POST
/restapis/{restapi_id}/requestvalidators
Creates a RequestValidator of a given RestApi.
CreateRequestValidator 8 params body → 201480481482483484485
GET
/restapis/{restapi_id}/requestvalidators
Gets the RequestValidators collection of a given RestApi.
GetRequestValidators 10 params → 200480481482483
POST
/restapis/{restapi_id}/resources/{parent_id}
Creates a Resource resource.
CreateResource 9 params body → 201480481482483484485
POST
/restapis
Creates a new RestApi resource.
CreateRestApi 7 params body → 201480481482483484
GET
/restapis
Lists the RestApis resources for your collection.
GetRestApis 9 params → 200480481482483
POST
/restapis/{restapi_id}/stages
Creates a new Stage resource that references a pre-existing Deployment for the API.
CreateStage 8 params body → 201480481482483484485
GET
/restapis/{restapi_id}/stages
Gets information about one or more Stage resources.
GetStages 9 params → 200480481482483484485
DELETE
/restapis/{restapi_id}/authorizers/{authorizer_id}
Deletes an existing Authorizer resource.
DeleteAuthorizer 9 params → 202480481482483484
GET
/restapis/{restapi_id}/authorizers/{authorizer_id}
Describe an existing Authorizer resource.
GetAuthorizer 9 params → 200480481482483
POST
/restapis/{restapi_id}/authorizers/{authorizer_id}
Simulate the execution of an Authorizer in your RestApi with headers, parameters, and an incoming request body.
TestInvokeAuthorizer 9 params body → 200480481482483
PATCH
/restapis/{restapi_id}/authorizers/{authorizer_id}
Updates an existing Authorizer resource.
UpdateAuthorizer 9 params body → 200480481482483484485
DELETE
/restapis/{restapi_id}/deployments/{deployment_id}
Deletes a Deployment resource. Deleting a deployment will only succeed if there are no Stage resources associated with it.
DeleteDeployment 9 params → 202480481482483484485
GET
/restapis/{restapi_id}/deployments/{deployment_id}
Gets information about a Deployment resource.
GetDeployment 10 params → 200480481482483484
PATCH
/restapis/{restapi_id}/deployments/{deployment_id}
Changes information about a Deployment resource.
UpdateDeployment 9 params body → 200480481482483484485486
DELETE
/restapis/{restapi_id}/documentation/parts/{part_id}
Deletes a documentation part
DeleteDocumentationPart 9 params → 202480481482483484
GET
/restapis/{restapi_id}/documentation/parts/{part_id}
Gets a documentation part.
GetDocumentationPart 9 params → 200480481482483
PATCH
/restapis/{restapi_id}/documentation/parts/{part_id}
Updates a documentation part.
UpdateDocumentationPart 9 params body → 200480481482483484485
DELETE
/restapis/{restapi_id}/documentation/versions/{doc_version}
Deletes a documentation version.
DeleteDocumentationVersion 9 params → 202480481482483484
GET
/restapis/{restapi_id}/documentation/versions/{doc_version}
Gets a documentation version.
GetDocumentationVersion 9 params → 200480481482
PATCH
/restapis/{restapi_id}/documentation/versions/{doc_version}
Updates a documentation version.
UpdateDocumentationVersion 9 params body → 200480481482483484485
DELETE
/restapis/{restapi_id}/gatewayresponses/{response_type}
Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.
DeleteGatewayResponse 9 params → 202480481482483484
GET
/restapis/{restapi_id}/gatewayresponses/{response_type}
Gets a GatewayResponse of a specified response type on the given RestApi.
GetGatewayResponse 9 params → 200480481482483
PUT
/restapis/{restapi_id}/gatewayresponses/{response_type}
Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi.
PutGatewayResponse 9 params body → 201480481482483484485
PATCH
/restapis/{restapi_id}/gatewayresponses/{response_type}
Updates a GatewayResponse of a specified response type on the given RestApi.
UpdateGatewayResponse 9 params body → 200480481482483484485
DELETE
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration
Represents a delete integration.
DeleteIntegration 10 params → 204480481482483484
GET
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration
Get the integration settings.
GetIntegration 10 params → 200480481482483
PUT
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration
Sets up a method's integration.
PutIntegration 10 params body → 201480481482483484485
PATCH
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration
Represents an update integration.
UpdateIntegration 10 params body → 200480481482483484485
DELETE
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration/responses/{status_code}
Represents a delete integration response.
DeleteIntegrationResponse 11 params → 204480481482483484
GET
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration/responses/{status_code}
Represents a get integration response.
GetIntegrationResponse 11 params → 200480481482483
PUT
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration/responses/{status_code}
Represents a put integration.
PutIntegrationResponse 11 params body → 201480481482483484485
PATCH
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/integration/responses/{status_code}
Represents an update integration response.
UpdateIntegrationResponse 11 params body → 200480481482483484485
DELETE
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}
Deletes an existing Method resource.
DeleteMethod 10 params → 204480481482483
GET
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}
Describe an existing Method resource.
GetMethod 10 params → 200480481482
PUT
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}
Add a method to an existing Resource resource.
PutMethod 10 params body → 201480481482483484485
POST
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}
Simulate the invocation of a Method in your RestApi with headers, parameters, and an incoming request body.
TestInvokeMethod 10 params body → 200480481482483
PATCH
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}
Updates an existing Method resource.
UpdateMethod 10 params body → 200480481482483484
DELETE
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/responses/{status_code}
Deletes an existing MethodResponse resource.
DeleteMethodResponse 11 params → 204480481482483484
GET
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/responses/{status_code}
Describes a MethodResponse resource.
GetMethodResponse 11 params → 200480481482
PUT
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/responses/{status_code}
Adds a MethodResponse to an existing Method resource.
PutMethodResponse 11 params body → 201480481482483484485
PATCH
/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}/responses/{status_code}
Updates an existing MethodResponse resource.
UpdateMethodResponse 11 params body → 201480481482483484485
DELETE
/restapis/{restapi_id}/models/{model_name}
Deletes a model.
DeleteModel 9 params → 202480481482483484
GET
/restapis/{restapi_id}/models/{model_name}
Describes an existing model defined for a RestApi resource.
GetModel 10 params → 200480481482483
PATCH
/restapis/{restapi_id}/models/{model_name}
Changes information about a model.
UpdateModel 9 params body → 200480481482483484485
DELETE
/restapis/{restapi_id}/requestvalidators/{requestvalidator_id}
Deletes a RequestValidator of a given RestApi.
DeleteRequestValidator 9 params → 202480481482483484
GET
/restapis/{restapi_id}/requestvalidators/{requestvalidator_id}
Gets a RequestValidator of a given RestApi.
GetRequestValidator 9 params → 200480481482483
PATCH
/restapis/{restapi_id}/requestvalidators/{requestvalidator_id}
Updates a RequestValidator of a given RestApi.
UpdateRequestValidator 9 params body → 200480481482483484485
DELETE
/restapis/{restapi_id}/resources/{resource_id}
Deletes a Resource resource.
DeleteResource 9 params → 202480481482483484
GET
/restapis/{restapi_id}/resources/{resource_id}
Lists information about a resource.
GetResource 10 params → 200480481482
PATCH
/restapis/{restapi_id}/resources/{resource_id}
Changes information about a Resource resource.
UpdateResource 9 params body → 200480481482483484
DELETE
/restapis/{restapi_id}
Deletes the specified API.
DeleteRestApi 8 params → 202480481482483484
GET
/restapis/{restapi_id}
Lists the RestApi resource in the collection.
GetRestApi 8 params → 200480481482483
PUT
/restapis/{restapi_id}
A feature of the API Gateway control service for updating an existing API with an input of external API definitions. The update can take the form of merging the supplied definition into the existing…
PutRestApi 11 params body → 200480481482483484485
PATCH
/restapis/{restapi_id}
Changes information about the specified API.
UpdateRestApi 8 params body → 200480481482483484485
DELETE
/restapis/{restapi_id}/stages/{stage_name}
Deletes a Stage resource.
DeleteStage 9 params → 202480481482483484485
GET
/restapis/{restapi_id}/stages/{stage_name}
Gets information about a Stage resource.
GetStage 9 params → 200480481482483484485
PATCH
/restapis/{restapi_id}/stages/{stage_name}
Changes information about a Stage resource.
UpdateStage 9 params body → 200480481482483484485
DELETE
/restapis/{restapi_id}/stages/{stage_name}/cache/authorizers
Flushes all authorizer cache entries on a stage.
FlushStageAuthorizersCache 9 params → 202480481482483484485
DELETE
/restapis/{restapi_id}/stages/{stage_name}/cache/data
Flushes a stage's cache.
FlushStageCache 9 params → 202480481482483484485
GET
/restapis/{restapi_id}/stages/{stage_name}/exports/{export_type}
Exports a deployed version of a RestApi in a specified format.
GetExport 12 params → 200480481482483484485
GET
/restapis/{restapi_id}/gatewayresponses
Gets the GatewayResponses collection on the given RestApi. If an API developer has not added any definitions for gateway responses, the result will be the API Gateway-generated default GatewayRespons…
GetGatewayResponses 10 params → 200480481482483
GET
/restapis/{restapi_id}/models/{model_name}/default_template
Generates a sample mapping template that can be used to transform a payload into the structure of a model.
GetModelTemplate 9 params → 200480481482483
GET
/restapis/{restapi_id}/resources
Lists information about a collection of Resource resources.
GetResources 11 params → 200480481482483
GET
/restapis/{restapi_id}/stages/{stage_name}/sdks/{sdk_type}
Generates a client SDK for a RestApi and Stage.
GetSdk 11 params → 200480481482483484485

Schemas 91

The contract defines 91 schemas that model the data the API accepts and returns. The most detailed are Stage (17 properties), Integration (15 properties), RestApi (13 properties), Method (11 properties). Each schema is shown below with its type and property counts.

Models
object
Represents a collection of Model resources.
2 properties
ListOfGatewayResponse
array
ListOfDocumentationVersion
array
MapOfMethod
object
ExportResponse
object
The binary blob response to GetExport, which contains the generated SDK.
1 property
RequestValidators
object
A collection of RequestValidator resources of a given RestApi.
2 properties
MapOfStringToString
object
UnauthorizedCacheControlHeaderStrategy
string
Authorizer
object
Represents an authorization layer for methods. If enabled on a method, API Gateway will activate the authorizer when a client calls the method.
10 properties
Model
object
Represents the data structure of a method's request or response payload.
5 properties
Template
object
Represents a mapping template used to transform a payload.
1 property
DocumentationPartLocationStatusCode
string
GatewayResponse
object
A gateway response of a given response type and status code, with optional response parameters and mapping templates.
5 properties
ConnectionType
string
NullableInteger
integer
Authorizers
object
Represents a collection of Authorizer resources.
2 properties
MapOfIntegrationResponse
object
DocumentationPartIds
object
A collection of the imported DocumentationPart identifiers.
2 properties
Stage
object
Represents a unique identifier for a version of a deployed RestApi that is callable by users.
17 properties
ListOfString
array
DocumentationPart
object
A documentation part for a targeted API entity.
3 properties
DocumentationPartType
string
MapOfMethodResponse
object
ProviderARN
string
ListOfStage
array
Method
object
Represents a client-facing interface by which the client calls the API to access back-end resources. A Method resource is integrated with an Integration resour…
11 properties
ListOfAuthorizer
array
ContentHandlingStrategy
string
DocumentationPartLocation
object
Specifies the target API entity to which the documentation applies.
5 properties 1 required
TestInvokeMethodResponse
object
Represents the response of the test invoke request in the HTTP method.
6 properties
Resource
object
Represents an API resource.
5 properties
CanarySettings
object
Configuration settings of a canary deployment.
4 properties
StatusCode
string
The status code.
IntegrationResponse
object
Represents an integration response. The status code must map to an existing MethodResponse, and parameters and templates can be used to transform the back-end…
5 properties
UnauthorizedException
String
string
DocumentationVersion
object
A snapshot of the documentation of an API.
3 properties
BadRequestException
TooManyRequestsException
Resources
object
Represents a collection of Resource resources.
2 properties
CacheClusterSize
string
Returns the size of the CacheCluster.
Deployments
object
Represents a collection resource that contains zero or more references to your existing deployments, and links that guide you on how to interact with your coll…
2 properties
RestApi
object
Represents a REST API.
13 properties
Stages
object
A list of Stage resources that are associated with the ApiKey resource.
1 property
MapOfStringToList
object
MethodSetting
object
Specifies the method setting properties.
10 properties
MapOfMethodSettings
object
EndpointConfiguration
object
The endpoint configuration to indicate the types of endpoints an API (RestApi) or its custom domain name (DomainName) has.
2 properties
TestInvokeAuthorizerResponse
object
Represents the response of the test invoke request for a custom Authorizer
7 properties
AccessLogSettings
object
Access log settings, including the access log format and access log destination ARN.
2 properties
ApiKeySourceType
string
Boolean
boolean
LimitExceededException
Timestamp
string
NullableBoolean
boolean
MethodSnapshot
object
Represents a summary of a Method resource, given a particular date and time.
2 properties
Integration
object
Represents an HTTP, HTTPPROXY, AWS, AWSPROXY, or Mock integration.
15 properties
GatewayResponseType
string
CacheClusterStatus
string
Returns the status of the CacheCluster.
Op
string
DocumentationVersions
object
The collection of documentation snapshots of an API.
2 properties
Integer
integer
ListOfModel
array
Deployment
object
An immutable representation of a RestApi resource that can be called by users using Stages. A deployment must be associated with a Stage for it to be callable…
4 properties
PathToMapOfMethodSnapshot
object
ConflictException
PatchOperation
object
For more information about supported patch operations, see Patch Operations .
4 properties
AuthorizerType
string
The authorizer type. Valid values are TOKEN for a Lambda function using a single authorization token submitted in a custom header, REQUEST for a Lambda functio…
ListOfRequestValidator
array
RequestValidator
object
A set of validation rules for incoming Method requests.
4 properties
SdkResponse
object
The binary blob response to GetSdk, which contains the generated SDK.
1 property
TlsConfig
object
Specifies the TLS configuration for an integration.
1 property
MapOfMethodSnapshot
object
MethodResponse
object
Represents a method response of a given HTTP status code returned to the client. The method response is passed from the back end through the associated integra…
3 properties
Long
integer
DocumentationParts
object
The collection of documentation parts of an API.
2 properties
ListOfRestApi
array
EndpointType
string
The endpoint type. The valid values are EDGE for edge-optimized API setup, most suitable for mobile applications; REGIONAL for regional API endpoint setup, mos…
ListOfDocumentationPart
array
RestApis
object
Contains references to your APIs and links that guide you in how to interact with your collection. A collection offers a paginated view of your APIs.
2 properties
ListOfARNs
array
Blob
string
NotFoundException
Double
number
ListOfResource
array
MapOfStringToBoolean
object
GatewayResponses
object
The collection of the GatewayResponse instances of a RestApi as a responseType -to-GatewayResponse object map of key-value pairs. As such, pagination is not su…
2 properties
ListOfEndpointType
array
ServiceUnavailableException
ListOfDeployment
array
IntegrationType
string
The integration type. The valid value is HTTP for integrating an API method with an HTTP backend; AWS with any AWS service endpoints; MOCK for testing without…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

engineering-platform-restapis-api-openapi.yml Raw ↑

Other APIs APIs.io Engineering Platform publishes across the network.

VSCode
AE Profile APIs.io
EasyCron
AE Profile APIs.io
APIs.io Engineering Platform 2014 11 13 API
AE Profile APIs.io
APIs.io Engineering Platform 2015 03 31 API
AE Profile APIs.io
APIs.io Engineering Platform 2016 08 19 API
AE Profile APIs.io
APIs.io Engineering Platform 2017 03 31 API
AE Profile APIs.io
APIs.io Engineering Platform 2017 10 31 API
AE Profile APIs.io
APIs.io Engineering Platform 2018 10 31 API
AE Profile APIs.io
APIs.io Engineering Platform 2019 09 25 API
AE Profile APIs.io
APIs.io Engineering Platform 2019 09 30 API
AE Profile APIs.io
APIs.io Engineering Platform 2020 04 22 API
AE Profile APIs.io
APIs.io Engineering Platform 2020 06 30 API
AE Profile APIs.io
#REST APIs
← Back to A APIs
API Details
ID
engineering-platform:engineering-platform-restapis-api
Base URL
https://{bucketname}.s3.amazonaws.com
Docs
https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html
Provider
APIs.io Engineering Platform
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=engineering-platform-restapis-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/engineering-platform-restapis-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of APIs.io Engineering Platform Restapis API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.