v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-142381,278956.3 KB

Lists the job executions for the specified thing.

Requires permission to access the ListJobExecutionsForThing action.

get/things/{thingName}/jobs

Path parameters

thingNamestring required

The thing name.

Query parameters

status'QUEUED' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'TIMED_OUT' | 'REJECTED' | 'REMOVED' | 'CANCELED'

An optional filter that lets you search for jobs that have the specified status.

namespaceIdstring
<p>The namespace used to indicate that a job is a customer-managed job.</p> <p>When you specify a value for this parameter, Amazon Web Services IoT Core sends jobs notifications to MQTT topics that contain the value in the following format.</p> <p> <code>$aws/things/<i>THING_NAME</i>/jobs/<i>JOB_ID</i>/notify-namespace-<i>NAMESPACE_ID</i>/</code> </p> <note> <p>The <code>namespaceId</code> feature is in public preview.</p> </note>
maxResultsinteger

The maximum number of results to be returned per request.

nextTokenstring

The token to retrieve the next set of results.

jobIdstring

The unique identifier you assigned to this job when it was created.

Response

Success

nextTokenstring

The token for the next set of results, or <b>null</b> if there are no additional results.