WorkflowExecutionInfo

WorkflowExecutionInfo Type - Temporal workflow execution details

Represents detailed information about a Temporal workflow execution. This type provides comprehensive data about running and completed workflows, including execution status, timing, and associated metadata.

History is NOT included in this type for performance reasons. To retrieve workflow history events, use the dedicated workflowHistory query.

Fields

Field	Type	Description
execution	WorkflowExecution!	The workflow execution identifier containing workflowId and runId
type	WorkflowType!	The type/name of the workflow
startTime	String!	ISO 8601 timestamp when the workflow started
closeTime	String	ISO 8601 timestamp when the workflow completed (null if still running)
status	String!	Current workflow status (e.g., RUNNING, COMPLETED, FAILED, CANCELED, TERMINATED, TIMED_OUT)
historyLength	Int!	Number of events in the workflow history
parentNamespaceId	String	Namespace ID of the parent workflow (if this is a child workflow)
parentExecution	WorkflowExecution	Parent workflow execution details (if this is a child workflow)
executionTime	String	ISO 8601 timestamp of execution time
memo	WorkflowMemo	Structured metadata associated with the workflow
searchAttributes	[TemporalMetadata!]!	Searchable attributes for workflow filtering
autoResetPoints	Map	Auto-reset points for workflow recovery
taskQueue	String!	The task queue this workflow is running on
stateTransitionCount	Int!	Number of state transitions in the workflow
historySizeBytes	Int!	Size of the workflow history in bytes
mostRecentWorkerVersionStamp	Map	Version stamp of the most recent worker
executionDuration	String	Duration of the workflow execution
rootExecution	WorkflowExecution	Root workflow execution (for nested child workflows)

Related Types

WorkflowExecution

Field	Type	Description
workflowId	String!	The unique workflow identifier
id	String!	The run ID for this specific execution

WorkflowType

Field	Type	Description
name	String!	The name of the workflow type

Service

This type is defined in the Workflow service.

Breaking Changes

History Field Removed

The history field has been removed from WorkflowExecutionInfo for performance reasons. Clients must now use the dedicated workflowHistory query to fetch workflow history events.

Before:

query {
  workflowExecutions(where: { workflowID: "my-workflow" }) {
    execution {
      workflowId
    }
    history {        # NO LONGER AVAILABLE
      eventId
      eventType
    }
  }
}

After:

# Step 1: Get execution metadata
query {
  workflowExecutions(where: { workflowID: "my-workflow" }) {
    edges {
      node {
        execution {
          workflowId
          id
        }
        status
        historyLength
      }
    }
  }
}

# Step 2: Fetch history separately
query {
  workflowHistory(where: { workflowID: "my-workflow" }) {
    edges {
      node {
        execution {
          workflowId
        }
        history {
          eventId
          eventType
          eventTime
        }
      }
    }
  }
}

Query Return Type Changed

The workflowExecutions query now returns WorkflowExecutionInfoConnection! instead of [WorkflowExecutionInfo!]!. This adds pagination support via the Relay connection pattern.

Before:

query {
  workflowExecutions(where: { ... }) {
    execution { workflowId }
    status
  }
}

After:

query {
  workflowExecutions(where: { ... }, first: 100) {
    edges {
      node {
        execution { workflowId }
        status
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Previous Breaking Change: Memo Field

The memo field type changed from Map (unstructured map[string]any) to WorkflowMemo (structured type with title, subtitle, and data fields).

Before:

query {
  workflowExecutions(where: { ... }) {
    edges {
      node {
        memo  # Was Map type
      }
    }
  }
}

After:

query {
  workflowExecutions(where: { ... }) {
    edges {
      node {
        memo {
          title
          subtitle
          data
        }
      }
    }
  }
}

Usage Example

Query Workflow Executions with Pagination

query {
  workflowExecutions(
    where: {
      typeName: "PickingWorkflow"
      status: "RUNNING"
    }
    first: 50
    orderBy: { direction: DESC, field: START_TIME }
  ) {
    edges {
      node {
        execution {
          workflowId
          id
        }
        type {
          name
        }
        startTime
        closeTime
        status
        historyLength
        taskQueue
        stateTransitionCount
        historySizeBytes
        memo {
          title
          subtitle
          data
        }
        searchAttributes {
          key
          value
        }
      }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
    totalCount
  }
}

Query with Multiple Filters

query {
  workflowExecutions(
    where: {
      and: [
        { typeNameIn: ["PickingWorkflow", "ReceivingWorkflow"] }
        { statusNotIn: ["COMPLETED", "FAILED"] }
        { startTimeGTE: "2024-01-01T00:00:00Z" }
      ]
    }
    first: 100
  ) {
    edges {
      node {
        execution {
          workflowId
          id
        }
        type {
          name
        }
        status
        startTime
        executionDuration
        memo {
          title
          subtitle
        }
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Query Child Workflows

query {
  workflowExecutions(
    where: {
      workflowIDHasPrefix: "child-"
    }
    first: 20
  ) {
    edges {
      node {
        execution {
          workflowId
          id
        }
        parentExecution {
          workflowId
          id
        }
        rootExecution {
          workflowId
          id
        }
        status
        memo {
          title
        }
      }
    }
  }
}

Paginating Through Results

# Initial query
query FirstPage {
  workflowExecutions(
    where: { status: "RUNNING" }
    first: 50
  ) {
    edges {
      node {
        execution { workflowId }
        status
      }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

# Subsequent pages
query NextPage($cursor: String!) {
  workflowExecutions(
    where: { status: "RUNNING" }
    first: 50
    after: $cursor
  ) {
    edges {
      node {
        execution { workflowId }
        status
      }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Example Response

{
  "data": {
    "workflowExecutions": {
      "edges": [
        {
          "node": {
            "execution": {
              "workflowId": "picking-order-12345",
              "id": "run-abc-123"
            },
            "type": {
              "name": "PickingWorkflow"
            },
            "startTime": "2024-01-15T10:30:00Z",
            "closeTime": null,
            "status": "RUNNING",
            "historyLength": 42,
            "taskQueue": "picking-queue",
            "stateTransitionCount": 15,
            "historySizeBytes": 8192,
            "memo": {
              "title": "Picking Order #12345",
              "subtitle": "Zone A - Priority High",
              "data": {
                "orderCount": 5,
                "assignee": "user-123"
              }
            },
            "searchAttributes": [
              { "key": "Service", "value": "picking" },
              { "key": "DataType", "value": "picking-order" }
            ]
          },
          "cursor": "eyJzdGFydFRpbWUiOiIyMDI0LTAxLTE1VDEwOjMwOjAwWiJ9"
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "endCursor": "eyJzdGFydFRpbWUiOiIyMDI0LTAxLTE1VDEwOjMwOjAwWiJ9"
      },
      "totalCount": 150
    }
  }
}

Workflow Status Values

Status	Description
RUNNING	Workflow is currently executing
COMPLETED	Workflow completed successfully
FAILED	Workflow failed with an error
CANCELED	Workflow was canceled
TERMINATED	Workflow was forcefully terminated
TIMED_OUT	Workflow exceeded its timeout
CONTINUED_AS_NEW	Workflow continued as a new execution

Related Documentation

• workflowExecutions Query - Query workflow executions with pagination

• workflowHistory Query - Query workflow history events

• WorkflowExecutionInfoConnection - Connection type for paginated results

• WorkflowExecutionHistory - Type for history retrieval

• WorkflowEvent - Individual event in workflow execution history

• WorkflowMemo - Structured workflow metadata type

• TemporalMetadata - Key-value metadata for search attributes

• Workflow - Workflow definition type

• TemporalWorkflow - Workflow execution reference type

Notes

• Use workflowExecutions query to retrieve workflow execution information with pagination

• History is NOT included - use workflowHistory query to fetch history events separately

• The memo field provides structured metadata for display and identification purposes

• Search attributes allow efficient filtering of workflows by custom criteria

• Parent and root execution references help track workflow hierarchies

• History size and length can be used to monitor workflow complexity

• Pagination uses Temporal's NextPageToken directly for efficient cursor-based pagination