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.BackgroundActivity retry delayed.
ActivityTimeoutMarks an Activity as timed‑out when its deadline passes.BackgroundActivity 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.ForegroundExternal call clean‑up/commit delayed.
CreateScheduleCreates a Temporal Schedule (cron‑like trigger).ForegroundClient/SDK receives ResourceExhaustedError, leading to backoff and retry.
CreateWorkflowRuleAdds a worker build‑ID versioning rule for a task queue.ForegroundRule enforcement is delayed.
DeleteScheduleDeletes an existing Schedule.ForegroundSchedule may keep firing briefly.
DeleteWorkerDeploymentDeletes a worker deployment record.ForegroundStale deployment metadata persists longer.
DeleteWorkerDeploymentVersionDeletes one build‑ID version entry under a deployment.ForegroundVersion appears valid until task processed.
DeleteWorkflowExecutionHard‑deletes workflow history and state.ForegroundStorage is freed later; data visible longer.
DeleteWorkflowRuleDeletes a worker build‑ID rule.ForegroundRule continues to exist until task handled.
DeprecateNamespaceMarks a namespace as deprecated in cluster metadata.ForegroundClients still see it as active.
DescribeBatchOperationReturns metadata for a batch operation.ForegroundAdmin/UI read waits longer.
DescribeDeploymentShows worker deployment details.ForegroundInfo retrieval is delayed.
DescribeNamespaceReturns namespace configuration.ForegroundAdmin read waits.
DescribeScheduleReads a Schedule’s current state.ForegroundCall responds slower.
DescribeTaskQueueReturns stats and configuration of a task queue.ForegroundMonitoring dashboards lag.
DescribeWorkerDeploymentShows details of a specific worker deployment.ForegroundSame delay in status.
DescribeWorkerDeploymentVersionShows a particular build‑ID version record.ForegroundDetail retrieval delayed.
DescribeWorkflowExecutionReturns high‑level info for a workflow execution.ForegroundDiagnostics/CLI wait longer.
DescribeWorkflowRuleReads a worker versioning rule.ForegroundAdmin tools wait.
DispatchByEndpointRoutes a Nexus task to workers by endpoint name.ForegroundTask routing latencies increase.
DispatchByNamespaceAndTaskQueueRoutes a Nexus task by namespace and task queue.ForegroundSame: Nexus task starts later.
ExecuteMultiOperationRuns a compound operation.ForegroundOperation is delayed
GetClusterInfoReturns information about cluster capabilities and versions.ForegroundCLI/API calls take longer.
GetCurrentDeploymentFetches the cluster‑wide current worker deployment.ForegroundRollout tooling sees stale info.
GetSearchAttributesLists custom search attribute definitions.ForegroundSDK/CLI wait.
GetSystemInfoReturns system build & feature info.ForegroundDiagnostic call delayed.
GetWorkerBuildIdCompatibilityReturns build‑ID compatibility matrix for a task queue.ForegroundRollout decisions wait.
GetWorkerVersioningRulesLists worker versioning rules.ForegroundAdmin listing delayed.
GetWorkflowExecutionHistoryStreams workflow history in forward order.ForegroundHistory load in UI/CLI is slow.
GetWorkflowExecutionHistoryReverseStreams history in reverse order.ForegroundSame slower history read.
ListNamespacesLists all namespaces in the cluster.ForegroundUI/CLI list paginates slower.
ListScheduleMatchingTimesComputes future fire‑times for a Schedule.ForegroundPreview takes longer.
ListTaskQueuePartitionsLists partitions backing a task queue.ForegroundLoad‑balancing insight lag.
ListWorkerDeploymentsLists all worker deployments.ForegroundDeployment inventory delayed.
ListWorkflowRulesLists all build‑ID versioning rules.ForegroundAdmin list wait.
PatchScheduleModifies an existing Schedule (e.g., add interval).ForegroundChange becomes effective later.
PauseActivityServer‑side API to pause a long‑running Activity.ForegroundActivity continues running until pause task processed.
PollActivityTaskQueueWorker long‑poll for Activity tasks.ForegroundActivity poller receives ResourceExhaustedError, leading to automatic backoff and retry, which slows down activity task processing.
PollNexusTaskQueueWorker long‑poll for Nexus tasks.ForegroundNexus task poller receives ResourceExhaustedError, leading to automatic backoff and retry, which slows down Nexus task processing.
PollWorkflowExecutionUpdateClient poll for workflow‑update completion.ForegroundClient waits extra for result.
PollWorkflowTaskQueueWorker long‑poll for Workflow Tasks.ForegroundWorkflow poller receives ResourceExhaustedError, leading to automatic backoff and retry, which slows down workflow progress.
QueryWorkflowRead‑only query on workflow state.ForegroundCaller receives result later.
RecordActivityTaskHeartbeatWorker heartbeat for an Activity (by task token).ForegroundHeartbeats delayed, risking false timeout.
RecordActivityTaskHeartbeatByIdSame heartbeat call using Activity/Run IDs.ForegroundSame impact.
RequestCancelWorkflowExecutionClient request to cancel a workflow.ForegroundCancellation propagates later.
ResetActivityForce‑restarts an Activity from scratch.ForegroundActivity keeps running before reset takes effect.
ResetStickyTaskQueueClears workflow’s sticky queue affinity.ForegroundTasks stay bound to prior worker longer.
ResetWorkflowExecutionServer‑side rewind to past event and continue as new.ForegroundWorkflow continues in old state.
RespondActivityTaskCanceledWorker confirms Activity canceled.ForegroundWorkflow waits for ack.
RespondActivityTaskCanceledByIdSame by ID.ForegroundSame wait.
RespondActivityTaskCompletedWorker returns Activity result.ForegroundWorkflow next step delayed.
RespondActivityTaskCompletedByIdSame by ID.ForegroundSame delay.
RespondActivityTaskFailedWorker reports Activity failure.ForegroundRetry/compensation delayed.
RespondActivityTaskFailedByIdSame by ID.ForegroundSame delay.
RespondNexusTaskCompletedWorker returns Nexus task success.ForegroundExternal call completion delayed.
RespondNexusTaskFailedWorker returns Nexus task failure.ForegroundError handling delayed.
RespondQueryTaskCompletedWorker returns query result.ForegroundClient waits longer.
RespondWorkflowTaskCompletedWorker returns new commands after WFT.ForegroundWorkflow commands applied later.
RespondWorkflowTaskFailedWorker reports WFT failure.ForegroundRetry/new task creation delayed.
SetCurrentDeploymentSets which worker deployment is current for a queue.ForegroundVersion switch postponed.
SetCurrentDeploymentVersionSets current build‑ID version number.ForegroundRollout holds.
SetWorkerDeploymentCurrentVersionSets version for a specific deployment.ForegroundDeployment stays on old version.
SetWorkerDeploymentRampingVersionSets percentage ramp for new version.ForegroundCanary rollout paused.
ShutdownWorkerGracefully shuts down a running worker via server call.ForegroundWorker keeps running a bit longer.
SignalWithStartWorkflowExecutionSignals an existing run or starts a new one with a signal.ForegroundSignal/start both delayed.
SignalWorkflowExecutionSends an asynchronous signal to a workflow.ForegroundSignal arrives late.
StartBatchOperationStarts a batch admin operation (e.g., bulk reset).ForegroundBatch begins later.
StartWorkflowExecutionCreates a new workflow run.ForegroundStart latency increases.
StateMachineOutboundEmits outbound commands generated by the new state‑machine core.BackgroundCommands queue up, deferring their side‑effects.
StateMachineTimerFires timers managed by the state‑machine core.BackgroundTimed events (e.g., sleeps) occur later.
StopBatchOperationStops/cancels a batch operation.ForegroundBatch keeps working until task processed.
TerminateWorkflowExecutionForce‑terminates a workflow run.ForegroundWorkflow continues running longer.
TransferActivityTaskDispatches an Activity task to a worker on its task queue.BackgroundActivity task schedule is delayed.
TransferCancelExecutionSends a cancel request to the target workflow.BackgroundTarget workflow receives the cancel later.
TransferCloseExecutionClose a running workflow executionBackgroundWorkflow remains open.
TransferResetWorkflowInitiates a reset of a workflow’s state/history.BackgroundReset is postponed; old state continues.
TransferSignalExecutionDelivers a signal event to another workflow.BackgroundSignal arrives late, delaying downstream logic.
TransferStartChildExecutionStarts a configured child workflow run.BackgroundChild workflow starts later than expected.
TransferWorkflowTaskSchedules a Workflow Task for workers.BackgroundWorkflow task schedule is delayed.
TriggerWorkflowRuleManually triggers a worker build‑ID rule.ForegroundTrigger effect deferred.
UnpauseActivityResumes a previously paused Activity.ForegroundActivity remains paused longer.
UpdateActivityOptionsUpdates retry/timeout options of a running Activity.ForegroundNew options take effect later.
UpdateScheduleUpdates fields of an existing Schedule.ForegroundUpdated schedule behavior delayed.
UpdateWorkerDeploymentVersionMetadataUpdates metadata on a deployment version.ForegroundMetadata remains outdated.
UpdateWorkflowExecutionServer‑side update (workflow update API).ForegroundUpdate is accepted later.
UpdateWorkflowExecutionOptionsChanges execution options (memo, search attributes).ForegroundOption changes visible later.
UserTimerFires a user‑defined timer created inside a workflow.BackgroundUser timer (including workflow sleep) fire event delayed.
VisibilityCloseExecutionUpdates a closed workflow in Visibility store.BackgroundClosed workflow remains open in list workflow visibility API results until task is processed.
VisibilityStartExecutionCreates a record for the workflow in Visibility store.BackgroundNew run is absent from lists in UI and CLI output until task processed.
VisibilityUpsertExecutionUpdates search attributes for a workflow run.BackgroundSearch attribute update is delayed.
WorkflowBackoffTimerTimer that delays retry or continued‑as‑new start per backoff policy.BackgroundWorkflow start delayed beyond intended backoff time.
WorkflowExecutionTimeoutEnforces the max total execution duration of a workflow.BackgroundTimeout of workflow execution chain is delayed.
WorkflowRunTimeoutEnforces timeout of an individual workflow run.BackgroundTimeout on workflow run is delayed.
WorkflowTaskTimeoutTimes out a Workflow Task that a worker hasn’t completed in time.BackgroundTimeout workflow task remains outstanding; retried workflow task is delayed.