---
name: aws-iot-jobs-data-plane
description: "AWS IoT Jobs Data Plane API skill. Use when working with AWS IoT Jobs Data Plane for things. Covers 4 endpoints."
version: 1.0.0
generator: lapsh
---

# AWS IoT Jobs Data Plane
API version: 2017-09-29

## Auth
AWS SigV4

## Base URL
Not specified.

## Setup
1. Configure auth: AWS SigV4
2. GET /things/{thingName}/jobs/{jobId} -- gets details of a job execution.
3. POST /things/{thingName}/jobs/{jobId} -- create first job

## Endpoints
4 endpoints across 1 group. See references/api-spec.lap for full details.

### Things
| Method | Path | Description |
|--------|------|-------------|
| GET | /things/{thingName}/jobs/{jobId} | Gets details of a job execution. |
| GET | /things/{thingName}/jobs | Gets the list of all jobs for a thing that are not in a terminal status. |
| PUT | /things/{thingName}/jobs/$next | Gets and starts the next pending (status IN_PROGRESS or QUEUED) job execution for a thing. |
| POST | /things/{thingName}/jobs/{jobId} | Updates the status of a job execution. |

## Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "Get job details?" -> GET /things/{thingName}/jobs/{jobId}
- "List all jobs?" -> GET /things/{thingName}/jobs
- "How to authenticate?" -> See Auth section above

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Create/update endpoints return the modified resource on success

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)