Input Reference

This page documents the input types used as arguments to the queries in the Query Reference.

Page

Used by workflows, workflowDeployments, and workflowExecutions to paginate list results. See Pagination for the full algorithm.

FieldTypeRequiredDescription
numberIntNoZero-indexed page number. Defaults to 0.
sizeIntNoNumber of items per page. Defaults to 10. Maximum 100.

WorkflowInput

Used by workflow.

FieldTypeRequiredDescription
uuidString!YesThe workflow's unique identifier.
fromTime!YesStart of the time window used to compute the workflow's aggregate fields.

WorkflowsInput

Used by workflows.

FieldTypeRequiredDescription
workflowOwnerAddress[OnchainAddress!]NoRestrict to workflows owned by one or more addresses. Maximum 100 entries.
status[WorkflowDeploymentStatus!]NoRestrict to one or more deployment statuses. Maximum 10 entries.
searchStringNoCase-insensitive text search on workflow name.
orderByWorkflowOrderByNoSort order.
pagePageNoPagination.

WorkflowOrderBy

FieldTypeRequiredDescription
fieldWorkflowOrderByField!YesField to sort by. See WorkflowOrderByField.
orderSortingOrder!YesSort direction. See SortingOrder.

WorkflowActivityInput

Used by workflowActivity.

FieldTypeRequiredDescription
workflowUUIDStringNoRestrict to a single workflow. Omit to aggregate across your organization.
fromTimeNoStart of the time range.
toTimeNoEnd of the time range.

WorkflowDeploymentInput

Used by workflowDeployment.

FieldTypeRequiredDescription
uuidString!YesThe deployment's unique identifier.

WorkflowDeploymentsInput

Used by workflowDeployments.

FieldTypeRequiredDescription
workflowUUIDString!YesThe workflow whose deployments should be returned.
status[WorkflowDeploymentStatus!]NoRestrict to one or more deployment statuses. Maximum 10 entries.
fromTimeNoOnly include deployments created on or after this time.
toTimeNoOnly include deployments created on or before this time.
searchStringNoText search filter.
orderByWorkflowDeploymentOrderByNoSort order.
pagePageNoPagination.

WorkflowDeploymentOrderBy

FieldTypeRequiredDescription
fieldWorkflowDeploymentOrderByField!YesField to sort by. See WorkflowDeploymentOrderByField.
orderSortingOrder!YesSort direction.

WorkflowExecutionInput

Used by workflowExecution.

FieldTypeRequiredDescription
uuidString!YesThe execution's unique identifier.

WorkflowExecutionsInput

Used by workflowExecutions.

FieldTypeRequiredDescription
workflowUuidStringNoRestrict to a single workflow. Omit to list executions across your organization.
status[WorkflowExecutionStatus!]NoRestrict to one or more execution statuses. Maximum 10 entries.
searchStringNoText search filter.
fromTimeNoOnly include executions started on or after this time.
toTimeNoOnly include executions started on or before this time.
orderByWorkflowExecutionOrderByNoSort order.
pagePageNoPagination.

WorkflowExecutionOrderBy

FieldTypeRequiredDescription
fieldWorkflowExecutionOrderByField!YesField to sort by. See WorkflowExecutionOrderByField.
orderSortingOrder!YesSort direction.

WorkflowExecutionLogsInput

Used by workflowExecutionLogs.

FieldTypeRequiredDescription
workflowExecutionUUIDString!YesThe execution whose logs should be returned.

WorkflowExecutionEventsInput

Used by workflowExecutionEvents.

FieldTypeRequiredDescription
workflowExecutionUUIDString!YesThe execution whose events should be returned.
capabilityIDStringNoRestrict results to a single capability.
statusStringNoRestrict results to a single event status string.

Filtering and sorting notes

  • List filters that accept arrays (status, workflowOwnerAddress) act as an OR — a workflow or execution matches if its value is in the given list.
  • Only one orderBy field can be specified per query; there is no multi-field sort.
  • search performs a case-insensitive substring match; there is no documented support for wildcards or regular expressions.
  • Filters can be combined freely within a single input object — for example, combining status and search on workflows narrows results by both.

Get the latest Chainlink content straight to your inbox.