# AWS IoT Jobs Data Plane API

> AWS IoT Jobs Data Plane API on Apizie: 4 endpoints (Gets details of a job execution., Updates the status of a job execution., Gets the list of all jobs for a thing that are not in a terminal status., Gets and starts the next pending (status IN_PROGRESS or QUEUED) job execution for a thing.) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:amazonaws-iot-jobs-data/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-iot-jobs-data`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://apizie.tech/api/cloud/amazonaws-iot-jobs-data
- OpenAPI: https://apizie.tech/api/cloud/amazonaws-iot-jobs-data/openapi.json

AWS IoT Jobs is a service that allows you to define a set of jobs — remote operations that are sent to and executed on one or more devices connected to AWS IoT. For example, you can define a job that instructs a set of…

## Endpoints

### Gets details of a job execution.
`GET https://apizie.tech/v1/cloud:amazonaws-iot-jobs-data/describe-job-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| jobId | string | yes | The unique identifier assigned to this job when it was created. |
| thingName | string | yes | The thing name associated with the device the job execution is running on. |
| includeJobDocument | boolean | no | Optional. When set to true, the response contains the job document. The default is false. |
| executionNumber | integer | no | Optional. A number that identifies a particular job execution on a particular device. If not specified, the latest job execution is… |

### Updates the status of a job execution.
`POST https://apizie.tech/v1/cloud:amazonaws-iot-jobs-data/update-job-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| jobId | string | yes | The unique identifier assigned to this job when it was created. |
| thingName | string | yes | The name of the thing associated with the device. |
| body | object | yes | JSON request body |

### Gets the list of all jobs for a thing that are not in a terminal status.
`GET https://apizie.tech/v1/cloud:amazonaws-iot-jobs-data/get-pending-job-executions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| thingName | string | yes | The name of the thing that is executing the job. |

### Gets and starts the next pending (status IN_PROGRESS or QUEUED) job execution for a thing.
`POST https://apizie.tech/v1/cloud:amazonaws-iot-jobs-data/start-next-pending-job-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| thingName | string | yes | The name of the thing associated with the device. |
| body | object | yes | JSON request body |

## Example
```
curl "https://apizie.tech/v1/cloud:amazonaws-iot-jobs-data/describe-job-execution" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS IoT Jobs Data Plane API?
Create a free Apizie key, then send GET https://apizie.tech/v1/cloud:amazonaws-iot-jobs-data/describe-job-execution with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the AWS IoT Jobs Data Plane API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. AWS IoT Jobs Data Plane itself also needs your own key from amazonaws.com.

### Can AI agents use the AWS IoT Jobs Data Plane API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-iot-jobs-data.

### What is the status of the AWS IoT Jobs Data Plane API?
Needs your own provider key (bring your own key)