Temporal for AI agents
Agents read Temporal at once. Changes and sends are held for a person's approval by default.
About Temporal
Cloud-native workflow orchestration platform for building reliable distributed applications
What an agent can do in Temporal
Every Temporal action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Temporal without asking first. 23 actions.
- Count SchedulesReturn an approximate count of Temporal Schedules matching a Schedule Visibility query, including grouped counts when requested. Requires Namespace Read access.
- Count WorkflowsReturn an approximate count of Workflow Executions matching a Temporal Visibility query, including supported grouped counts. Requires Namespace Read access.
- Describe Batch OperationReturn progress, state, selection query, type, and failure counts for one batch operation in an authorized Temporal Cloud Namespace. Requires Namespace Read access.
- Describe NamespaceReturn one Temporal Cloud Namespace's configuration, resource version, routing endpoints, state, limits, and capacity. Requires Namespace Read access.
- Describe ScheduleReturn the complete current definition, state, execution information, Memo, Search Attributes, and conflict token for one Temporal Schedule. Use this before a full replacement update to preserve inten
- Describe WorkflowReturn configuration, status, pending work, callbacks, and child state for one Workflow Execution in an authorized Temporal Cloud Namespace. Omit run_id to describe the current run. Requires Namespace
- Describe Workflow RuleReturn one configured Temporal Workflow Rule, including its trigger, Visibility query, actions, expiration, creation metadata, and description. Requires Namespace Read access.
- Get Async OperationReturn the current state and failure details of a Temporal Cloud asynchronous operation.
- Get Export SinkReturn one Temporal Cloud Workflow History export sink, including its resource version, destination configuration, state, and health. Requires Namespace Read access.
- Get Namespace CapacityReturn a Temporal Cloud Namespace's capacity mode, available limits, and seven-day actions-per-second statistics. Requires Namespace Read access.
- Get Cloud RegionReturn details for one Temporal Cloud region, including its cloud provider, provider-specific identifier, and human-readable location.
- Get Workflow HistoryReturn one page of a Temporal Workflow Execution's Event History in forward or reverse order. Requires Namespace Read access.
Show all 23
- List Archived WorkflowsReturn one page of archived Workflow Executions matching an exact Temporal Visibility query. Requires Namespace Read access and a Namespace deployment with archival visibility configured and available
- List Batch OperationsReturn one page of batch operations in an authorized Temporal Cloud Namespace. Requires Namespace Read access.
- List Export SinksReturn one page of Workflow History export sinks configured on a Temporal Cloud Namespace. Requires Namespace Read access.
- List Namespace AssignmentsReturn one page of users, User Groups, or Service Accounts assigned to a Temporal Cloud Namespace. Requires Namespace Read access.
- List NamespacesReturn one page of Temporal Cloud Namespaces visible to the API-key identity, optionally filtered by name or Project.
- List Cloud RegionsList currently available Temporal Cloud regions for Namespace placement.
- List Schedule Matching TimesList times within a required start-to-end range that match one Temporal Schedule's timing specification. Requires Namespace Read access.
- List SchedulesReturn one filtered page of Temporal Schedules in an authorized Temporal Cloud Namespace. Requires Namespace Read access.
- List Workflow RulesReturn one page of Workflow Rules configured for an authorized Temporal Cloud Namespace. Requires Namespace Read access.
- List WorkflowsSearch one page of Workflow Executions in an authorized Temporal Cloud Namespace using Temporal Visibility query syntax. Requires Namespace Read access.
- Query WorkflowRun a synchronous, read-only Query handler against one Temporal Workflow Execution. The handler runs in Workflow context but cannot mutate Workflow state. Requires Namespace Read access.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 40 actions.
- Batch Cancel WorkflowsRequest cancellation of selected Temporal Workflows. Cancellation is cooperative: Workflow code can perform cleanup and external side effects before closing. Preview the exact Visibility query with CO
- Batch Delete WorkflowsWARNING: Permanently delete selected Temporal Workflow Executions and their Event Histories. This cannot be undone. Preview the exact Visibility query with COUNT_WORKFLOWS and obtain approval for the
- Batch Reset WorkflowsWARNING: Irreversibly reset selected Temporal Workflows. Each successful reset terminates the current run and creates a new run; replay and reapplied events can repeat application code and external si
- Batch Signal WorkflowsSend a named Signal to selected Temporal Workflows. Signal handlers run application code and can cause arbitrary, non-idempotent external side effects. Preview the exact Visibility query with COUNT_WO
- Batch Terminate WorkflowsWARNING: Irreversibly terminate selected Temporal Workflows immediately; Workflow cleanup code does not run. Preview the exact Visibility query with COUNT_WORKFLOWS and obtain approval for the observe
- Batch Update Workflow OptionsUpdate typed execution options on selected Temporal Workflows. Worker routing, task priority, and virtual-time changes can cause application and external side effects. Preview the exact Visibility que
- Cancel WorkflowIrreversibly request cooperative cancellation of a running Temporal Workflow Execution. Temporal records a cancellation-requested event and schedules a Workflow Task, but the Workflow may delay or ign
- Create and Apply Workflow RuleCreate a Namespace-wide Temporal Workflow Rule and immediately start a batch job applying it to matching currently running Workflows. This may pause Activities across many executions and cause irrever
- Create Export SinkCreate a persistent Temporal Cloud Workflow History export sink asynchronously. Requires Namespace Admin access. Warning: an enabled sink writes closed Workflow Histories to external storage on an ong
- Create ScheduleCreate a Temporal Schedule that starts a configured Workflow on cron, interval, calendar, or structured-calendar times. The Workflow may perform arbitrary application side effects. Use request_id for
- Create Workflow RuleCreate a Namespace-wide Temporal Workflow Rule that can pause matching Activities when its trigger occurs. This does not scan currently running Workflows; use Create and Apply Workflow Rule for that s
- Delete Export SinkDelete a Temporal Cloud Workflow History export sink asynchronously. Requires Namespace Admin access. WARNING: this irreversibly stops future exports from the sink. Files already exported to external
Show all 40
- Delete NamespacePermanently and irreversibly delete a Temporal Cloud Namespace and all of its Workflow data asynchronously. WARNING: there is no recovery or undo. Use only for a verified disposable Namespace after co
- Delete SchedulePermanently delete one Temporal Schedule from a Namespace. WARNING: schedule deletion cannot be undone, but it does not terminate or otherwise affect Workflow Executions the Schedule already started.
- Delete Workflow RulePermanently delete one configured Temporal Workflow Rule from a Namespace. WARNING: deletion cannot be undone; after deletion the rule no longer applies to new triggering events. Confirm the Namespace
- Fail Over Namespace RegionSwitch a multi-region Temporal Cloud Namespace's active region asynchronously. WARNING: This operation disrupts current Namespace routing while failover completes. Require explicit approval and a docu
- Move Namespace To ProjectMove a Temporal Cloud Namespace to another Project asynchronously. WARNING: this disruptive operation can change inherited access and connectivity. Verify the source and destination Projects, preserve
- Patch ScheduleApply targeted changes to a Temporal Schedule without replacing its definition: pause or unpause it, trigger one immediate action, or backfill historical times. Immediate and backfill operations start
- Pause WorkflowPause one Temporal Workflow Execution. Temporal changes its status to PAUSED, records a WORKFLOW_EXECUTION_PAUSED event, stops dispatching new Workflow and Activity Tasks, pauses executing Activities,
- Register NamespaceCreate a billable, persistent Temporal Cloud Namespace asynchronously and return its full Namespace ID and operation ID. The name and replicas are immutable, and custom Search Attributes cannot be del
- Remove Namespace AccessRemove one user's, user group's, or service account's direct permission on a Temporal Cloud Namespace by setting PERMISSION_UNSPECIFIED. Requires Namespace Admin. WARNING: this can immediately remove
- Rename Custom Search AttributeRename one custom Search Attribute in a Temporal Cloud Namespace asynchronously. This is a potentially breaking schema mutation: Temporal does not rewrite application Visibility queries or dashboards
- Replace WorkflowReplace a running Workflow Execution with a new execution using the same Workflow ID. WARNING: if that ID is running, Temporal irreversibly terminates the existing execution before starting the replac
- Reset WorkflowWARNING: Irreversibly reset a Temporal Workflow to a selected Workflow Task event. Temporal terminates the current run and creates a new run; replay and reapplied events can repeat application code an
- Set Namespace AccessSet one user's, user group's, or service account's direct ADMIN, WRITE, or READ permission on a Temporal Cloud Namespace. The new permission replaces that principal's current direct access; setting a
- Signal With Start WorkflowAtomically signal a running Temporal Workflow or start and signal it when absent. This may run application code and trigger external side effects; use a stable request_id when retrying the same intent
- Signal WorkflowSend an asynchronous Signal to one running Temporal Workflow Execution. This records a history event, schedules Workflow code, and may trigger arbitrary external business side effects. Temporal's succ
- Start or Get WorkflowStart a Workflow Execution, or return the already-running execution when the Workflow ID conflicts. This action never replaces the running execution. The response has started=false when it returns the
- Start WorkflowStart a new Workflow Execution in an authorized Temporal Cloud Namespace. The request fails if the Workflow ID is already running; use Start or Get Workflow or Replace Workflow only when those differe
- Stop Batch OperationRequest that Temporal stop an in-progress batch operation. This does not roll back Workflows already processed by the batch: their cancellations, terminations, signals, deletions, resets, or option ch
- Terminate WorkflowImmediately and irreversibly terminate one Temporal Workflow Execution. WARNING: termination bypasses cooperative cancellation and Workflow cleanup logic, so finally blocks, compensation, and pending
- Trigger Workflow RuleTrigger an existing configured Temporal Workflow Rule against one Workflow Execution. This irreversible request evaluates the rule and, when its conditions match, may run configured actions with destr
- Unpause WorkflowResume a paused Temporal Workflow Execution. Unpausing changes its status to running, records an unpaused history event, and resumes application code in Workflow and Activity Tasks, which may produce
- Update Export SinkUpdate an existing Temporal Cloud Workflow History export sink asynchronously using optimistic concurrency. WARNING: this replaces the sink's destination configuration or enabled state for future expo
- Update NamespaceUpdate a Temporal Cloud Namespace specification asynchronously using the latest resource version for optimistic concurrency. WARNING: this full-spec replacement can change retention, regions, capacity
- Update Namespace TagsUpsert or permanently remove tags on a Temporal Cloud Namespace asynchronously; removed tags no longer exist on the Namespace. At least one of tags_to_upsert or tags_to_remove must be non-empty, and t
- Update ScheduleFully replace an existing Temporal Schedule's spec, Workflow-start action, policies, and state. Omitted values in those structures are not preserved; supply the complete desired replacement configurat
- Update WorkflowSend a durable Update to one Temporal Workflow Execution and wait for the requested lifecycle stage. The Workflow handler may mutate state and cause arbitrary external business side effects. Reuse upd
- Update Workflow OptionsUpdate selected options on one Temporal Workflow Execution using an exact protobuf FieldMask. This mutation can reroute Workflow Tasks to different Workers, change task priority, or alter virtual-time
- Validate Export SinkValidate a Temporal Cloud Workflow History export sink configuration. WARNING: this is not read-only; Temporal writes an empty test object to the configured external bucket or container. Use only an o
Changes wait in Needs you
Changes and sends in Temporal are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
Temporal questions
Can an agent change data in Temporal on its own?
Not by default. Changes and sends in Temporal are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Temporal?
This connector lists 23 read actions. Reads run at once, without waiting for approval.
How does Temporal connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.