Skip to main content

Operations

Temporal Cloud rate limits operations per second (OPS) per namespace. An operation is anything 1. a user does directly, or 2. Temporal does on behalf of the user in the background that results in load on Temporal Server. The exception is visibility queries: they do hit the Server (the query is passed from the server to the visibility store), but primarily the load is on the visibility system. Visibility rate limits are separate from OPS rate limits.

Below is the list of operations, including:

  • operation name
  • description
  • priority (foreground is higher priority, background is lower priority)
  • effect of that operation being throttled
OperationDescriptionPriorityEffect of Throttling
ActivityRetryTimerInternal timer that schedules the retry of a failed Activity execution.ForegroundActivity retry delayed.
ActivityTimeoutMarks an Activity as timed‑out when its deadline passes.ForegroundActivity task stays in-flight longer and timeout is delayed, so retry is also delayed (if there is a retry).
CompleteNexusOperationFinalises a Nexus operation after worker response.BackgroundExternal call clean‑up/commit delayed.
CreateScheduleCreates a Temporal Schedule (cron‑like trigger).BackgroundClient/SDK receives ResourceExhaustedError, leading to backoff and retry.
CreateWorkflowRuleAdds a worker build‑ID versioning rule for a task queue.BackgroundRule enforcement is delayed.
DeleteScheduleDeletes an existing Schedule.BackgroundSchedule may keep firing briefly.
DeleteWorkerDeploymentDeletes a worker deployment record.BackgroundStale deployment metadata persists longer.
DeleteWorkerDeploymentVersionDeletes one build‑ID version entry under a deployment.BackgroundVersion appears valid until task processed.
DeleteWorkflowExecutionHard‑deletes workflow history and state.BackgroundStorage is freed later; data visible longer.
DeleteWorkflowRuleDeletes a worker build‑ID rule.BackgroundRule continues to exist until task handled.
DeprecateNamespaceMarks a namespace as deprecated in cluster metadata.BackgroundClients still see it as active.
DescribeBatchOperationReturns metadata for a batch operation.BackgroundAdmin/UI read waits longer.
DescribeDeploymentShows worker deployment details.BackgroundInfo retrieval is delayed.
DescribeNamespaceReturns namespace configuration.BackgroundAdmin read waits.
DescribeScheduleReads a Schedule’s current state.BackgroundCall responds slower.
DescribeTaskQueueReturns stats and configuration of a task queue.BackgroundMonitoring dashboards lag.
DescribeWorkerDeploymentShows details of a specific worker deployment.BackgroundSame delay in status.
DescribeWorkerDeploymentVersionShows a particular build‑ID version record.BackgroundDetail retrieval delayed.
DescribeWorkflowExecutionReturns high‑level info for a workflow execution.BackgroundDiagnostics/CLI wait longer.
DescribeWorkflowRuleReads a worker versioning rule.BackgroundAdmin tools wait.
DispatchByEndpointRoutes a Nexus task to workers by endpoint name.BackgroundTask routing latencies increase.
DispatchByNamespaceAndTaskQueueRoutes a Nexus task by namespace and task queue.BackgroundSame: Nexus task starts later.
ExecuteMultiOperationRuns a compound operation.BackgroundOperation is delayed
GetClusterInfoReturns information about cluster capabilities and versions.BackgroundCLI/API calls take longer.
GetCurrentDeploymentFetches the cluster‑wide current worker deployment.BackgroundRollout tooling sees stale info.
GetSearchAttributesLists custom search attribute definitions.BackgroundSDK/CLI wait.
GetSystemInfoReturns system build & feature info.BackgroundDiagnostic call delayed.
GetWorkerBuildIdCompatibilityReturns build‑ID compatibility matrix for a task queue.BackgroundRollout decisions wait.
GetWorkerVersioningRulesLists worker versioning rules.BackgroundAdmin listing delayed.
GetWorkflowExecutionHistoryStreams workflow history in forward order.BackgroundHistory load in UI/CLI is slow.
GetWorkflowExecutionHistoryReverseStreams history in reverse order.BackgroundSame slower history read.
ListNamespacesLists all namespaces in the cluster.BackgroundUI/CLI list paginates slower.
ListScheduleMatchingTimesComputes future fire‑times for a Schedule.BackgroundPreview takes longer.
ListTaskQueuePartitionsLists partitions backing a task queue.BackgroundLoad‑balancing insight lag.
ListWorkerDeploymentsLists all worker deployments.BackgroundDeployment inventory delayed.
ListWorkflowRulesLists all build‑ID versioning rules.BackgroundAdmin list wait.
PatchScheduleModifies an existing Schedule (e.g., add interval).BackgroundChange becomes effective later.
PauseActivityServer‑side API to pause a long‑running Activity.BackgroundActivity continues running until pause task processed.
PollActivityTaskQueueWorker long‑poll for Activity tasks.BackgroundActivity poller receives ResourceExhaustedError, leading to automatic backoff and retry, which slows down activity task processing.
PollNexusTaskQueueWorker long‑poll for Nexus tasks.BackgroundNexus task poller receives ResourceExhaustedError, leading to automatic backoff and retry, which slows down Nexus task processing.
PollWorkflowExecutionUpdateClient poll for workflow‑update completion.BackgroundClient waits extra for result.
PollWorkflowTaskQueueWorker long‑poll for Workflow Tasks.BackgroundWorkflow poller receives ResourceExhaustedError, leading to automatic backoff and retry, which slows down workflow progress.
QueryWorkflowRead‑only query on workflow state.BackgroundCaller receives result later.
RecordActivityTaskHeartbeatWorker heartbeat for an Activity (by task token).BackgroundHeartbeats delayed, risking false timeout.
RecordActivityTaskHeartbeatByIdSame heartbeat call using Activity/Run IDs.BackgroundSame impact.
RequestCancelWorkflowExecutionClient request to cancel a workflow.BackgroundCancellation propagates later.
ResetActivityForce‑restarts an Activity from scratch.BackgroundActivity keeps running before reset takes effect.
ResetStickyTaskQueueClears workflow’s sticky queue affinity.BackgroundTasks stay bound to prior worker longer.
ResetWorkflowExecutionServer‑side rewind to past event and continue as new.BackgroundWorkflow continues in old state.
RespondActivityTaskCanceledWorker confirms Activity canceled.BackgroundWorkflow waits for ack.
RespondActivityTaskCanceledByIdSame by ID.BackgroundSame wait.
RespondActivityTaskCompletedWorker returns Activity result.BackgroundWorkflow next step delayed.
RespondActivityTaskCompletedByIdSame by ID.BackgroundSame delay.
RespondActivityTaskFailedWorker reports Activity failure.BackgroundRetry/compensation delayed.
RespondActivityTaskFailedByIdSame by ID.BackgroundSame delay.
RespondNexusTaskCompletedWorker returns Nexus task success.BackgroundExternal call completion delayed.
RespondNexusTaskFailedWorker returns Nexus task failure.BackgroundError handling delayed.
RespondQueryTaskCompletedWorker returns query result.BackgroundClient waits longer.
RespondWorkflowTaskCompletedWorker returns new commands after WFT.BackgroundWorkflow commands applied later.
RespondWorkflowTaskFailedWorker reports WFT failure.BackgroundRetry/new task creation delayed.
SetCurrentDeploymentSets which worker deployment is current for a queue.BackgroundVersion switch postponed.
SetCurrentDeploymentVersionSets current build‑ID version number.BackgroundRollout holds.
SetWorkerDeploymentCurrentVersionSets version for a specific deployment.BackgroundDeployment stays on old version.
SetWorkerDeploymentRampingVersionSets percentage ramp for new version.BackgroundCanary rollout paused.
ShutdownWorkerGracefully shuts down a running worker via server call.BackgroundWorker keeps running a bit longer.
SignalWithStartWorkflowExecutionSignals an existing run or starts a new one with a signal.BackgroundSignal/start both delayed.
SignalWorkflowExecutionSends an asynchronous signal to a workflow.BackgroundSignal arrives late.
StartBatchOperationStarts a batch admin operation (e.g., bulk reset).BackgroundBatch begins later.
StartWorkflowExecutionCreates a new workflow run.BackgroundStart latency increases.
StateMachineOutboundEmits outbound commands generated by the new state‑machine core.ForegroundCommands queue up, deferring their side‑effects.
StateMachineTimerFires timers managed by the state‑machine core.ForegroundTimed events (e.g., sleeps) occur later.
StopBatchOperationStops/cancels a batch operation.BackgroundBatch keeps working until task processed.
TerminateWorkflowExecutionForce‑terminates a workflow run.BackgroundWorkflow continues running longer.
TransferActivityTaskDispatches an Activity task to a worker on its task queue.ForegroundActivity task schedule is delayed.
TransferCancelExecutionSends a cancel request to the target workflow.ForegroundTarget workflow receives the cancel later.
TransferCloseExecutionClose a running workflow executionForegroundWorkflow remains open.
TransferResetWorkflowInitiates a reset of a workflow’s state/history.ForegroundReset is postponed; old state continues.
TransferSignalExecutionDelivers a signal event to another workflow.ForegroundSignal arrives late, delaying downstream logic.
TransferStartChildExecutionStarts a configured child workflow run.ForegroundChild workflow starts later than expected.
TransferWorkflowTaskSchedules a Workflow Task for workers.ForegroundWorkflow task schedule is delayed.
TriggerWorkflowRuleManually triggers a worker build‑ID rule.BackgroundTrigger effect deferred.
UnpauseActivityResumes a previously paused Activity.BackgroundActivity remains paused longer.
UpdateActivityOptionsUpdates retry/timeout options of a running Activity.BackgroundNew options take effect later.
UpdateScheduleUpdates fields of an existing Schedule.BackgroundUpdated schedule behavior delayed.
UpdateWorkerDeploymentVersionMetadataUpdates metadata on a deployment version.BackgroundMetadata remains outdated.
UpdateWorkflowExecutionServer‑side update (workflow update API).BackgroundUpdate is accepted later.
UpdateWorkflowExecutionOptionsChanges execution options (memo, search attributes).BackgroundOption changes visible later.
UserTimerFires a user‑defined timer created inside a workflow.ForegroundUser timer (including workflow sleep) fire event delayed.
VisibilityCloseExecutionUpdates a closed workflow in Visibility store.ForegroundClosed workflow remains open in list workflow visibility API results until task is processed.
VisibilityStartExecutionCreates a record for the workflow in Visibility store.ForegroundNew run is absent from lists in UI and CLI output until task processed.
VisibilityUpsertExecutionUpdates search attributes for a workflow run.ForegroundSearch attribute update is delayed.
WorkflowBackoffTimerTimer that delays retry or continued‑as‑new start per backoff policy.ForegroundWorkflow start delayed beyond intended backoff time.
WorkflowExecutionTimeoutEnforces the max total execution duration of a workflow.ForegroundTimeout of workflow execution chain is delayed.
WorkflowRunTimeoutEnforces timeout of an individual workflow run.ForegroundTimeout on workflow run is delayed.
WorkflowTaskTimeoutTimes out a Workflow Task that a worker hasn’t completed in time.ForegroundTimeout workflow task remains outstanding; retried workflow task is delayed.