Amazon IoT Device Management Detect API is one of 69 APIs that Amazon IoT Device Management 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 Device Management 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
InternalFailureException
TaskAlreadyExistsException
PolicyTemplateName
string
ThrottlingException
DetectMitigationActionsTaskSummaryList
array
MitigationActionList
array
MitigationAction
object
Describes which changes should be applied as part of a mitigation action.
4 properties
GenericLongValue
integer
TargetViolationIdsForDetectMitigationActions
array
RoleArn
string
AddThingsToThingGroupParams
object
Parameters used when defining a mitigation action that move a set of things to a thing group.
2 properties1 required
DetectMitigationActionExecutionErrorCode
string
DeviceCertificateUpdateAction
string
InvalidRequestException
DetectMitigationActionsTaskTarget
object
The target of a mitigation action task.
3 properties
DescribeDetectMitigationActionsTaskResponse
object
1 property
ListDetectMitigationActionsTasksResponse
object
2 properties
DetectMitigationActionsTaskStatus
string
DetectMitigationActionExecution
object
Describes which mitigation actions should be executed.
9 properties
ThingGroupName
string
ViolationEventOccurrenceRange
object
Specifies the time period of which violation events occurred between.
2 properties2 required
PrimitiveBoolean
boolean
EnableIoTLoggingParams
object
Parameters used when defining a mitigation action that enable Amazon Web Services IoT Core logging.
2 properties2 required
ListDetectMitigationActionsExecutionsResponse
object
2 properties
SnsTopicArn
string
BehaviorName
string
MitigationActionName
string
ReplaceDefaultPolicyVersionParams
object
Parameters to define a mitigation action that adds a blank policy to restrict permissions.
1 property1 required
DetectMitigationActionsTaskSummary
object
The summary of the mitigation action tasks.
10 properties
ViolationId
string
DeviceDefenderThingName
string
NextToken
string
UpdateDeviceCertificateParams
object
Parameters to define a mitigation action that changes the state of the device certificate to inactive.
1 property1 required
CancelDetectMitigationActionsTaskResponse
object
MitigationActionsTaskId
string
StartDetectMitigationActionsTaskResponse
object
1 property
Timestamp
string
LimitExceededException
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
SecurityProfileName
string
NullableBoolean
boolean
ErrorMessage
string
ResourceNotFoundException
UpdateCACertificateParams
object
Parameters to define a mitigation action that changes the state of the CA certificate to inactive.
1 property1 required
CACertificateUpdateAction
string
DetectMitigationActionExecutionStatus
string
LogLevel
string
DetectMitigationActionExecutionList
array
ThingGroupNames
array
DetectMitigationActionsTaskStatistics
object
The statistics of a mitigation action task.
3 properties
MitigationActionId
string
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 Device Management 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.
