AWS IoT Things Graph
Welcome (API Version 2018-09-06)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.


Searches for AWS IoT Things Graph workflow execution instances.

Request Syntax

{ "endTime": number, "flowExecutionId": "string", "maxResults": number, "nextToken": "string", "startTime": number, "systemInstanceId": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.


The date and time of the latest flow execution to return.

Type: Timestamp

Required: No


The ID of a flow execution.

Type: String

Required: No


The maximum number of results to return in the response.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 250.

Required: No


The string that specifies the next page of results. Use this when you're paginating results.

Type: String

Required: No


The date and time of the earliest flow execution to return.

Type: Timestamp

Required: No


The ID of the system instance that contains the flow.

Type: String

Length Constraints: Maximum length of 160.

Pattern: ^urn:tdm:(([a-z]{2}-(gov-)?[a-z]{4,9}-[0-9]{1,3}/[0-9]+/)*[\p{Alnum}_]+(/[\p{Alnum}_]+)*):([\p{Alpha}]*):([\p{Alnum}_]+(/[\p{Alnum}_]+)*)$

Required: Yes

Response Syntax

{ "nextToken": "string", "summaries": [ { "createdAt": number, "flowExecutionId": "string", "flowTemplateId": "string", "status": "string", "systemInstanceId": "string", "updatedAt": number } ] }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


The string to specify as nextToken when you request the next page of results.

Type: String


An array of objects that contain summary information about each workflow execution in the result set.

Type: Array of FlowExecutionSummary objects


For information about the errors that are common to all actions, see Common Errors.


HTTP Status Code: 500


HTTP Status Code: 400


HTTP Status Code: 400


HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: