Suger

get operation details

GET https://api.suger.cloud/org/{orgId}/v2/operation/{operationId}

Get the details of a Temporal workflow operation by operation ID. Optionally include child workflow data.

Parameters

NameInTypeRequiredDescription
orgId path string yes Organization ID
operationId path string yes Temporal Workflow ID
runId query string no Temporal run ID of the workflow
hasChildren query boolean no Include data aggregated from all child workflows (1 level), default false

Responses

200 — OK

Content-Type: application/json · Schema: Operation

Operation fields:

FieldTypeRequiredDescription
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

400 — Bad request error

Content-Type: application/json

500 — Internal server error

Content-Type: application/json


View as Markdown · Interactive API reference

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