Amazon IoT Core Detect API is one of 70 APIs that Amazon IoT Core publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Detect. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and pricing.
This API exposes
5 operations
across 4 paths,
and defines 52 schemas.
It is described by OpenAPI 3.2.0, at version 1.0.0.
Requests are made against 4 base URLs: http://iot.{region}.amazonaws.com, https://iot.{region}.amazonaws.com, http://iot.{region}.amazonaws.com.cn, https://iot.{region}.amazonaws.com.cn.
5 operations4 paths52 schemas3 GET2 PUT
Metadata
The identity and technical contract details declared by the specification.
Amazon IoT Core Detect 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 5
Across 4 paths, the API surfaces 5 operations — 3 GET, 2 PUT. Each is listed below with its method, path, parameters, and response codes.
The contract defines 52 schemas that model the data the API accepts and returns. The most detailed are DetectMitigationActionsTaskSummary (10 properties), DetectMitigationActionExecution (9 properties), MitigationActionParams (6 properties), MitigationAction (4 properties). Each schema is shown below with its type and property counts.
PublishFindingToSnsParams
object
Parameters to define a mitigation action that publishes findings to Amazon SNS. You can implement your own custom actions in response to the Amazon SNS message…
1 property1 required
AddThingsToThingGroupParams
object
Parameters used when defining a mitigation action that move a set of things to a thing group.
2 properties1 required
TaskAlreadyExistsException
DetectMitigationActionExecutionStatus
string
LogLevel
string
ListDetectMitigationActionsExecutionsResponse
object
2 properties
MitigationActionParams
object
The set of parameters for this mitigation action. You can specify only one type of parameter (in other words, you can apply only one action for each defined mi…
6 properties
UpdateCACertificateParams
object
Parameters to define a mitigation action that changes the state of the CA certificate to inactive.
1 property1 required
ThingGroupName
string
TargetViolationIdsForDetectMitigationActions
array
MitigationActionName
string
DeviceCertificateUpdateAction
string
ThrottlingException
MitigationActionList
array
BehaviorName
string
InvalidRequestException
DetectMitigationActionExecutionList
array
DetectMitigationActionExecution
object
Describes which mitigation actions should be executed.
9 properties
DescribeDetectMitigationActionsTaskResponse
object
1 property
NextToken
string
MitigationActionsTaskId
string
SecurityProfileName
string
ResourceNotFoundException
ErrorMessage
string
RoleArn
string
DetectMitigationActionsTaskStatus
string
MitigationActionId
string
UpdateDeviceCertificateParams
object
Parameters to define a mitigation action that changes the state of the device certificate to inactive.
1 property1 required
DetectMitigationActionsTaskTarget
object
The target of a mitigation action task.
3 properties
DetectMitigationActionsTaskSummaryList
array
PolicyTemplateName
string
Timestamp
string
DeviceDefenderThingName
string
NullableBoolean
boolean
InternalFailureException
ListDetectMitigationActionsTasksResponse
object
2 properties
PrimitiveBoolean
boolean
ReplaceDefaultPolicyVersionParams
object
Parameters to define a mitigation action that adds a blank policy to restrict permissions.
1 property1 required
StartDetectMitigationActionsTaskResponse
object
1 property
CancelDetectMitigationActionsTaskResponse
object
ThingGroupNames
array
DetectMitigationActionsTaskSummary
object
The summary of the mitigation action tasks.
10 properties
ViolationEventOccurrenceRange
object
Specifies the time period of which violation events occurred between.
2 properties2 required
MitigationAction
object
Describes which changes should be applied as part of a mitigation action.
4 properties
GenericLongValue
integer
DetectMitigationActionsTaskStatistics
object
The statistics of a mitigation action task.
3 properties
ViolationId
string
DetectMitigationActionExecutionErrorCode
string
CACertificateUpdateAction
string
SnsTopicArn
string
LimitExceededException
EnableIoTLoggingParams
object
Parameters used when defining a mitigation action that enable Amazon Web Services IoT Core logging.
2 properties2 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
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.
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 Amazon IoT Core Detect 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.
