Amazon IoT Core Iot Core Versions API
The Iot Core Versions API from Amazon IoT Core — 2 operation(s) for iot core versions.
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-iot-core:amazon-iot-core-versions-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 Specification
openapi: 3.2.0
info:
title: AWS IoT Versions API
version: '2015-05-28'
description: Generated from AWS's published Smithy model for AWS IoT. 5 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://iot.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
tags:
- name: Versions
paths:
/packages/{packageName}/versions/{versionName}:
put:
operationId: CreatePackageVersion
summary: Create Package Version
description: Creates a new version for an existing IoT software package. Requires permission to access the CreatePackageVersion and GetIndexingConfiguration actions.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/CreatePackageVersionResponse'
'409':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'402':
description: ServiceQuotaExceededException
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceQuotaExceededException'
'400':
description: ThrottlingException; ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreatePackageVersionRequest'
tags:
- Versions
delete:
operationId: DeletePackageVersion
summary: Delete Package Version
description: 'Deletes a specific version from a software package. Note: If a package version is designated as default, you must remove the designation from the software package using the UpdatePackage action.'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DeletePackageVersionResponse'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'400':
description: ThrottlingException; ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DeletePackageVersionRequest'
tags:
- Versions
get:
operationId: GetPackageVersion
summary: Get Package Version
description: Gets information about the specified package version. Requires permission to access the GetPackageVersion action.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/GetPackageVersionResponse'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'400':
description: ThrottlingException; ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GetPackageVersionRequest'
tags:
- Versions
patch:
operationId: UpdatePackageVersion
summary: Update Package Version
description: Updates the supported fields for a specific package version. Requires permission to access the UpdatePackageVersion and GetIndexingConfiguration actions.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UpdatePackageVersionResponse'
'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'
'400':
description: ThrottlingException; ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdatePackageVersionRequest'
tags:
- Versions
/packages/{packageName}/versions:
get:
operationId: ListPackageVersions
summary: List Package Versions
description: Lists the software package versions associated to the account. Requires permission to access the ListPackageVersions action.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListPackageVersionsResponse'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'400':
description: ThrottlingException; ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListPackageVersionsRequest'
tags:
- Versions
components:
schemas:
S3Location:
type: object
properties:
bucket:
type: string
description: The S3 bucket.
key:
type: string
description: The S3 key.
version:
type: string
description: The S3 bucket version.
PackageVersionSummary:
type: object
properties:
packageName:
type: string
description: The name of the associated software package.
versionName:
type: string
description: The name of the target package version.
status:
type: string
enum:
- DRAFT
- PUBLISHED
- DEPRECATED
description: The status of the package version. For more information, see Package version lifecycle.
creationDate:
type: string
format: date-time
description: The date that the package version was created.
lastModifiedDate:
type: string
format: date-time
description: The date that the package version was last updated.
UpdatePackageVersionResponse:
type: object
properties: {}
GetPackageVersionRequest:
type: object
properties:
packageName:
type: string
description: The name of the associated package.
versionName:
type: string
description: The name of the target package version.
required:
- packageName
- versionName
Sbom:
type: object
properties:
s3Location:
$ref: '#/components/schemas/S3Location'
ListPackageVersionsResponse:
type: object
properties:
packageVersionSummaries:
type: array
items:
$ref: '#/components/schemas/PackageVersionSummary'
description: Lists the package versions associated to the package.
nextToken:
type: string
description: The token for the next set of results.
CreatePackageVersionResponse:
type: object
properties:
packageVersionArn:
type: string
description: The Amazon Resource Name (ARN) for the package.
packageName:
type: string
description: The name of the associated software package.
versionName:
type: string
description: The name of the new package version.
description:
type: string
description: The package version description.
attributes:
type: object
additionalProperties:
type: string
description: Metadata that were added to the package version that can be used to define a package version’s configuration.
status:
type: string
enum:
- DRAFT
- PUBLISHED
- DEPRECATED
description: The status of the package version. For more information, see Package version lifecycle.
errorReason:
type: string
description: Error reason for a package version failure during creation or update.
ResourceNotFoundException:
type: object
properties:
message:
type: string
description: The message for the exception.
ThrottlingException:
type: object
properties:
message:
type: string
description: The message for the exception.
ConflictException:
type: object
properties:
message:
type: string
resourceId:
type: string
description: A resource with the same name already exists.
GetPackageVersionResponse:
type: object
properties:
packageVersionArn:
type: string
description: The ARN for the package version.
packageName:
type: string
description: The name of the software package.
versionName:
type: string
description: The name of the package version.
description:
type: string
description: The package version description.
attributes:
type: object
additionalProperties:
type: string
description: Metadata that were added to the package version that can be used to define a package version’s configuration.
artifact:
$ref: '#/components/schemas/PackageVersionArtifact'
status:
type: string
enum:
- DRAFT
- PUBLISHED
- DEPRECATED
description: The status associated to the package version. For more information, see Package version lifecycle.
errorReason:
type: string
description: Error reason for a package version failure during creation or update.
creationDate:
type: string
format: date-time
description: The date when the package version was created.
lastModifiedDate:
type: string
format: date-time
description: The date when the package version was last updated.
sbom:
$ref: '#/components/schemas/Sbom'
sbomValidationStatus:
type: string
enum:
- IN_PROGRESS
- FAILED
- SUCCEEDED
description: The status of the validation for a new software bill of materials added to a software package version.
recipe:
type: string
description: The inline job document associated with a software package version used for a quick job deployment.
InternalServerException:
type: object
properties:
message:
type: string
DeletePackageVersionResponse:
type: object
properties: {}
PackageVersionArtifact:
type: object
properties:
s3Location:
$ref: '#/components/schemas/S3Location'
CreatePackageVersionRequest:
type: object
properties:
packageName:
type: string
description: The name of the associated software package.
versionName:
type: string
description: The name of the new package version.
description:
type: string
description: A summary of the package version being created. This can be used to outline the package's contents or purpose.
attributes:
type: object
additionalProperties:
type: string
description: Metadata that can be used to define a package version’s configuration. For example, the S3 file location, configuration options that are being sent to the device or fleet. The combined size of all the attributes on a package version is limited to 3KB.
artifact:
$ref: '#/components/schemas/PackageVersionArtifact'
recipe:
type: string
description: The inline job document associated with a software package version used for a quick job deployment.
tags:
type: object
additionalProperties:
type: string
description: Metadata that can be used to manage the package version.
clientToken:
type: string
description: A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.
required:
- packageName
- versionName
ServiceQuotaExceededException:
type: object
properties:
message:
type: string
ListPackageVersionsRequest:
type: object
properties:
packageName:
type: string
description: The name of the target software package.
status:
type: string
enum:
- DRAFT
- PUBLISHED
- DEPRECATED
description: The status of the package version. For more information, see Package version lifecycle.
maxResults:
type: integer
description: The maximum number of results to return at one time.
nextToken:
type: string
description: The token for the next set of results.
required:
- packageName
DeletePackageVersionRequest:
type: object
properties:
packageName:
type: string
description: The name of the associated software package.
versionName:
type: string
description: The name of the target package version.
clientToken:
type: string
description: A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.
required:
- packageName
- versionName
UpdatePackageVersionRequest:
type: object
properties:
packageName:
type: string
description: The name of the associated software package.
versionName:
type: string
description: The name of the target package version.
description:
type: string
description: The package version description.
attributes:
type: object
additionalProperties:
type: string
description: 'Metadata that can be used to define a package version’s configuration. For example, the Amazon S3 file location, configuration options that are being sent to the device or fleet. Note: Attributes can be updated only when the package version is in a draft state. The combined size of all the attributes on a package version is limited to 3KB.'
artifact:
$ref: '#/components/schemas/PackageVersionArtifact'
action:
type: string
enum:
- PUBLISH
- DEPRECATE
description: The status that the package version should be assigned. For more information, see Package version lifecycle.
recipe:
type: string
description: The inline job document associated with a software package version used for a quick job deployment.
clientToken:
type: string
description: A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.
required:
- packageName
- versionName
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: iot
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/iot/service/2015-05-28/iot-2015-05-28.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)