list operations with filters

POST https://api.suger.cloud/org/{orgId}/v2/operation/list

List or search workflow operations with filter expressions.

Parameters

Name	In	Type	Required	Description
`orgId`	path	string	yes	Organization ID

Required. Content-Type: application/json · Schema: ListOperationsV2Request

ListOperationsV2Request fields:

Field	Type	Required	Description
`filter`	OperationFilter	no
`limit`	integer	no	Limit the number of results returned (1-100), default 100
`offsetToken`	string	no	OffsetToken for pagination, use nextOffsetToken from previous response

OperationFilter fields:

Field	Type	Required	Description
`args`	array<OperationFilter>	no	Args for logical operators (and, or)
`field`	TemporalWorkflowAttr	no
`operator`	string	no	Operator: "=", "!=", "in", "not_in", "and", "or"
`value`	object	no	Value for single value operators (=, !=, etc)
`values`	array<object>	no	Values for array operators (in, not_in)

Content-Type: application/json · Schema: ListOperationsResponse

ListOperationsResponse fields:

Field	Type	Required	Description
`offsetToken`	string	no
`operations`	array<Operation>	no

Operation fields:

Field	Type	Required	Description
`childCompleted`	integer	no
`childFailed`	integer	no	ChildFailed sums Failed + Terminated + TimedOut + Canceled.
`childOffsetToken`	string	no	Pagination token for the next page of ChildWorkflowOperations. Empty string means no more pages. Pass back as `childOffsetToken` query param.
`childTotal`	integer	no	Aggregate child counts from the visibility index. Populated alongside ChildWorkflowOperations when the parent is a batch workflow. Use these for total/success/failure stats rather than len(ChildWorkflowOperations). `omitempty` is intentionally omitted: callers distinguish "BE populated these" from "fall back" by field presence, so zero must round-trip.
`childWorkflowOperations`	array<Operation>	no	Only populated if it has child workflows. Otherwise it is nil. May be a truncated page; ChildTotal/ChildCompleted/ChildFailed reflect the full aggregate from Temporal's visibility index.
`endTime`	string	no
`id`	string	no	Operation ID.
`memo`	object	no
`message`	string	no
`name`	string	no
`runId`	string	no	Run ID.
`startTime`	string	no
`status`	string	no
`type`	OperationType	no

Content-Type: application/json

Content-Type: application/json

Spotted something wrong or out of date on this page? Tell us and we'll correct it.