githubEdit

object-groupWorkflowExecutionInfoConnection

WorkflowExecutionInfoConnection Type - Paginated workflow execution results

Audience: Programmer

A connection type for paginated access to workflow execution information. This type follows the Relay connection specification and is returned by the workflowExecutions query.

This connection provides efficient pagination through potentially large result sets of workflow executions, using Temporal's NextPageToken for cursor-based navigation.

Fields

Field
Type
Description

edges

[WorkflowExecutionInfoEdge!]!

List of workflow execution info edges

pageInfo

WorkflowExecutionPageInfo!

Information for pagination

totalCount

Int!

Total number of matching workflow executions

WorkflowExecutionInfoEdge

Field
Type
Description

node

WorkflowExecutionInfo!

The workflow execution information

cursor

String!

Cursor for use in pagination

WorkflowExecutionPageInfo

Field
Type
Description

hasNextPage

Boolean!

Whether there are more items after this page

hasPreviousPage

Boolean!

Whether there are more items before this page

startCursor

String

Cursor of the first item

endCursor

String

Cursor of the last item

Service

This type is defined in the Workflow service.

Usage Example

Basic Paginated Query

Paginating Through Results

Example Response

Breaking Change

This connection type is new and replaces the previous array return type of the workflowExecutions query.

Before:

After:

Notes

  • This connection provides lightweight execution metadata WITHOUT history

  • To fetch history, use the workflowHistory query with WorkflowExecutionHistoryConnection

  • Pagination uses Temporal's NextPageToken directly, encoded in the cursor

  • Default page size is 100 if first is not specified

  • Use totalCount to display the total number of matching executions

Last updated

Was this helpful?