Amazon Web Services Things API
The Things API from Amazon Web Services — 11 operation(s) for things.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-web-services-things-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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
openapi: 3.2.0
info:
title: Amazon Web Services Things API
version: '1.0'
description: 'Operations tagged Things across 3 of this provider''s published API definitions: iot-data-openapi-original.yml, iot-jobs-data-openapi-original.yml, iot-openapi-original.yml. Each path carries the servers of the definition it was published in.'
tags:
- name: Things
paths:
/things/{thingName}/shadow:
POST:
summary: Amazon Web Services Updatethingshadow
description: Updates the shadow for the specified thing. Requires permission to access the UpdateThingShadow action. For more information, see UpdateThingShadow in the IoT Developer Guide.
operationId: amazonWebServicesUpdateThingShadow
tags:
- Things
/api/things/shadow/ListNamedShadowsForThing/{thingName}:
GET:
summary: Amazon Web Services Listnamedshadowsforthing
description: Lists the shadows for the specified thing. Requires permission to access the ListNamedShadowsForThing action.
operationId: amazonWebServicesListNamedShadowsForThing
tags:
- Things
/things/{thingName}/jobs/{jobId}:
POST:
summary: Amazon Web Services Updatejobexecution
description: Updates the status of a job execution.
operationId: amazonWebServicesUpdateJobExecution
tags:
- Things
GET:
summary: Amazon Web Services Describejobexecution
description: Describes a job execution. Requires permission to access the DescribeJobExecution action.
operationId: amazonWebServicesDescribeJobExecution
tags:
- Things
/things/{thingName}/jobs:
GET:
summary: Amazon Web Services Getpendingjobexecutions
description: Gets the list of all jobs for a thing that are not in a terminal status.
operationId: amazonWebServicesGetPendingJobExecutions
tags:
- Things
/things/{thingName}/jobs/$next:
PUT:
summary: Amazon Web Services Startnextpendingjobexecution
description: Gets and starts the next pending (status IN_PROGRESS or QUEUED) job execution for a thing.
operationId: amazonWebServicesStartNextPendingJobExecution
tags:
- Things
/things/{thingName}/principals:
GET:
summary: Amazon Web Services Listthingprincipals
description: Lists the principals associated with the specified thing. A principal can be X.509 certificates, IAM users, groups, and roles, Amazon Cognito identities or federated identities. Requires permission to access the ListThingPrincipals action.
operationId: amazonWebServicesListThingPrincipals
tags:
- Things
/things/{thingName}/jobs/{jobId}/cancel:
PUT:
summary: Amazon Web Services Canceljobexecution
description: Cancels the execution of a job for a given thing. Requires permission to access the CancelJobExecution action.
operationId: amazonWebServicesCancelJobExecution
tags:
- Things
/things/{thingName}:
PATCH:
summary: Amazon Web Services Updatething
description: Updates the data for a thing. Requires permission to access the UpdateThing action.
operationId: amazonWebServicesUpdateThing
tags:
- Things
/things/{thingName}/jobs/{jobId}/executionNumber/{executionNumber}:
DELETE:
summary: Amazon Web Services Deletejobexecution
description: Deletes a job execution. Requires permission to access the DeleteJobExecution action.
operationId: amazonWebServicesDeleteJobExecution
tags:
- Things
/things/{thingName}/thing-groups:
GET:
summary: Amazon Web Services Listthinggroupsforthing
description: List the thing groups to which the specified thing belongs. Requires permission to access the ListThingGroupsForThing action.
operationId: amazonWebServicesListThingGroupsForThing
tags:
- Things
/things:
POST:
summary: Amazon Web Services Registerthing
description: Provisions a thing in the device registry. RegisterThing calls other IoT control plane APIs. These calls might exceed your account level IoT Throttling Limits and cause throttle errors. Please contact Amazon Web Services Customer Support to raise your throttling limits if necessary. Requires permission to access the RegisterThing action.
operationId: amazonWebServicesRegisterThing
tags:
- Things
x-refined-from:
- iot-data-openapi-original.yml
- iot-jobs-data-openapi-original.yml
- iot-openapi-original.yml