WorkflowSignals

Workflow Signals Query

Returns a paginated list of WorkflowSignal objects, with optional filtering and ordering. Workflow signals define events that can start or control workflow executions in the Temporal workflow engine.

Arguments

Name	Type	Description
after	Cursor	Returns the elements in the list that come after the specified cursor
first	Int	Returns the first n elements from the list
before	Cursor	Returns the elements in the list that come before the specified cursor
last	Int	Returns the last n elements from the list
orderBy	WorkflowSignalOrder	Ordering options for workflow signals returned from the connection
where	WorkflowSignalWhereInput	Filtering options for workflow signals returned from the connection

Return Type

WorkflowSignalConnection! - A connection to a list of WorkflowSignal objects with pagination information.

Usage Example

query {
  # Get workflow signals that start workflows
  workflowSignals(
    where: {
      start: true
    },
    orderBy: { direction: DESC, field: CREATED_AT }
  ) {
    edges {
      node {
        id
        workflowID
        eventName
        start
        dataTypeSlug
        data
        createdAt
        workflow {
          id
          name
          active
        }
      }
      cursor
    }
    totalCount
  }
}

query {
  # Search signals by event name
  workflowSignals(
    where: {
      eventNameContains: "order"
    },
    first: 20
  ) {
    edges {
      node {
        id
        workflowID
        eventName
        start
        data
        workflow {
          id
          name
          active
          filterRule
        }
      }
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
  }
}

query {
  # Get signals for specific workflow
  workflowSignals(
    where: {
      workflowID: "01234567-89ab-cdef-0123-456789abcdef"
    }
  ) {
    edges {
      node {
        id
        eventName
        start
        data
        createdAt
        workflow {
          name
          active
        }
      }
    }
  }
}

Common Filters

• eventNameContains - Search by event name substring

• eventName - Find by exact event name

• start - Filter by whether signal starts workflow

• workflowID - Filter by associated workflow

• dataTypeSlug - Filter by data type slug

• hasWorkflow - Filter signals that have associated workflow

• hasWorkflowWith - Filter by workflow criteria

• tenantID - Filter by tenant

Notes

• Workflow signals connect events to workflow executions

• Start signals trigger new workflow instances

• Non-start signals control existing workflow instances

• Event names correspond to business events in the system

• Integration with Temporal.io workflow engine for reliable processing

• Support custom fields through data/dataType system

• Essential for event-driven workflow orchestration and process automation