---
canonical_url: "https://docs.composio.dev/toolkits/temporal"
markdown_url: "https://docs.composio.dev/toolkits/temporal.md"
product: "platform"
version: null
last_updated: null
---

# Temporal

Cloud-native workflow orchestration platform for building reliable distributed applications

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 63
- **Triggers:** 0
- **Slug:** `TEMPORAL`
- **Version:** 20261001_00

## Tools

### Batch Cancel Workflows

**Slug:** `TEMPORAL_BATCH_CANCEL_WORKFLOWS`

Request 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 COUNT_WORKFLOWS and obtain approval for the observed scope; its approximate count is not a hard upper bound because matches can change. Use explicit target_executions when a fixed cardinality bound is required. A stable job_id identifies this operation but does not make retries idempotently successful. After an ambiguous timeout, a retry may return 409 because Temporal rejects duplicate job IDs. Call DESCRIBE_BATCH_OPERATION with the same namespace_id and job_id to reconcile before creating any other batch operation. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Stable ID that identifies this batch operation. Temporal rejects duplicate job IDs instead of treating a retry as idempotent success. After an ambiguous timeout, a retry with this ID may return a conflict even if the operation started; call DESCRIBE_BATCH_OPERATION with the same namespace_id and job_id to reconcile before creating any other batch operation. |
| `reason` | string | Yes | Human-readable audit reason recorded for this batch operation. |
| `identity` | string | No | Optional caller name recorded by Temporal for audit attribution. Keep the default unless a specific service or operator identity should be recorded. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host. |
| `visibility_query` | string | No | SQL-like filter scoped to this Namespace. Attribute names are case-sensitive. Use =, !=, >, >=, <, <=, IN (...), BETWEEN ... AND ..., IS NULL, IS NOT NULL, STARTS_WITH, AND, OR, and parentheses. Quote strings and RFC3339 timestamps with single or double quotes; wrap custom attribute names containing non-alphanumeric characters in backticks. Common attributes include WorkflowId, WorkflowType, ExecutionStatus, StartTime, CloseTime, ExecutionTime, RunId, and TaskQueue. Temporal Cloud does not support ORDER BY. Example: `ExecutionStatus = 'Running' AND WorkflowType = 'OrderWorkflow'`. Before starting, call COUNT_WORKFLOWS with this exact query and obtain approval for the observed scope. Its count is approximate and matches can change, so the preview is not a hard upper bound. Mutually exclusive with target_executions. |
| `target_executions` | array | No | Explicit non-empty Workflow targets. Use these instead of a Visibility query when the list length must be a hard cardinality bound. Mutually exclusive with visibility_query. |
| `max_operations_per_second` | number | No | Positive processing-rate ceiling. Temporal may enforce a lower rate. This limits throughput, not the number of matching Workflows, and is not a cardinality safety bound. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Batch Delete Workflows

**Slug:** `TEMPORAL_BATCH_DELETE_WORKFLOWS`

WARNING: 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 observed scope; its approximate count is not a hard upper bound because matches can change. Use explicit target_executions when a fixed cardinality bound is required. A stable job_id identifies this operation but does not make retries idempotently successful. After an ambiguous timeout, a retry may return 409 because Temporal rejects duplicate job IDs. Call DESCRIBE_BATCH_OPERATION with the same namespace_id and job_id to reconcile before creating any other batch operation. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Stable ID that identifies this batch operation. Temporal rejects duplicate job IDs instead of treating a retry as idempotent success. After an ambiguous timeout, a retry with this ID may return a conflict even if the operation started; call DESCRIBE_BATCH_OPERATION with the same namespace_id and job_id to reconcile before creating any other batch operation. |
| `reason` | string | Yes | Human-readable audit reason recorded for this batch operation. |
| `identity` | string | No | Optional caller name recorded by Temporal for audit attribution. Keep the default unless a specific service or operator identity should be recorded. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host. |
| `visibility_query` | string | No | SQL-like filter scoped to this Namespace. Attribute names are case-sensitive. Use =, !=, >, >=, <, <=, IN (...), BETWEEN ... AND ..., IS NULL, IS NOT NULL, STARTS_WITH, AND, OR, and parentheses. Quote strings and RFC3339 timestamps with single or double quotes; wrap custom attribute names containing non-alphanumeric characters in backticks. Common attributes include WorkflowId, WorkflowType, ExecutionStatus, StartTime, CloseTime, ExecutionTime, RunId, and TaskQueue. Temporal Cloud does not support ORDER BY. Example: `ExecutionStatus = 'Running' AND WorkflowType = 'OrderWorkflow'`. Before starting, call COUNT_WORKFLOWS with this exact query and obtain approval for the observed scope. Its count is approximate and matches can change, so the preview is not a hard upper bound. Mutually exclusive with target_executions. |
| `target_executions` | array | No | Explicit non-empty Workflow targets. Use these instead of a Visibility query when the list length must be a hard cardinality bound. Mutually exclusive with visibility_query. |
| `max_operations_per_second` | number | No | Positive processing-rate ceiling. Temporal may enforce a lower rate. This limits throughput, not the number of matching Workflows, and is not a cardinality safety bound. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Batch Reset Workflows

**Slug:** `TEMPORAL_BATCH_RESET_WORKFLOWS`

WARNING: 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 side effects. Preview the exact Visibility query with COUNT_WORKFLOWS and obtain approval for the observed scope; its approximate count is not a hard upper bound because matches can change. Use explicit target_executions when a fixed cardinality bound is required. A stable job_id identifies this operation but does not make retries idempotently successful. After an ambiguous timeout, a retry may return 409 because Temporal rejects duplicate job IDs. Call DESCRIBE_BATCH_OPERATION with the same namespace_id and job_id to reconcile before creating any other batch operation. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Stable ID that identifies this batch operation. Temporal rejects duplicate job IDs instead of treating a retry as idempotent success. After an ambiguous timeout, a retry with this ID may return a conflict even if the operation started; call DESCRIBE_BATCH_OPERATION with the same namespace_id and job_id to reconcile before creating any other batch operation. |
| `reason` | string | Yes | Human-readable audit reason recorded for this batch operation. |
| `options` | object | Yes | Typed reset point and event-reapplication policy. Every selected current run is terminated and replaced by a new run when its reset succeeds. |
| `identity` | string | No | Optional caller name recorded by Temporal for audit attribution. Keep the default unless a specific service or operator identity should be recorded. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host. |
| `visibility_query` | string | No | SQL-like filter scoped to this Namespace. Attribute names are case-sensitive. Use =, !=, >, >=, <, <=, IN (...), BETWEEN ... AND ..., IS NULL, IS NOT NULL, STARTS_WITH, AND, OR, and parentheses. Quote strings and RFC3339 timestamps with single or double quotes; wrap custom attribute names containing non-alphanumeric characters in backticks. Common attributes include WorkflowId, WorkflowType, ExecutionStatus, StartTime, CloseTime, ExecutionTime, RunId, and TaskQueue. Temporal Cloud does not support ORDER BY. Example: `ExecutionStatus = 'Running' AND WorkflowType = 'OrderWorkflow'`. Before starting, call COUNT_WORKFLOWS with this exact query and obtain approval for the observed scope. Its count is approximate and matches can change, so the preview is not a hard upper bound. Mutually exclusive with target_executions. |
| `target_executions` | array | No | Explicit non-empty Workflow targets. Use these instead of a Visibility query when the list length must be a hard cardinality bound. Mutually exclusive with visibility_query. |
| `max_operations_per_second` | number | No | Positive processing-rate ceiling. Temporal may enforce a lower rate. This limits throughput, not the number of matching Workflows, and is not a cardinality safety bound. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Batch Signal Workflows

**Slug:** `TEMPORAL_BATCH_SIGNAL_WORKFLOWS`

Send 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_WORKFLOWS and obtain approval for the observed scope; its approximate count is not a hard upper bound because matches can change. Use explicit target_executions when a fixed cardinality bound is required. A stable job_id identifies this operation but does not make retries idempotently successful. After an ambiguous timeout, a retry may return 409 because Temporal rejects duplicate job IDs. Call DESCRIBE_BATCH_OPERATION with the same namespace_id and job_id to reconcile before creating any other batch operation. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Stable ID that identifies this batch operation. Temporal rejects duplicate job IDs instead of treating a retry as idempotent success. After an ambiguous timeout, a retry with this ID may return a conflict even if the operation started; call DESCRIBE_BATCH_OPERATION with the same namespace_id and job_id to reconcile before creating any other batch operation. |
| `reason` | string | Yes | Human-readable audit reason recorded for this batch operation. |
| `identity` | string | No | Optional caller name recorded by Temporal for audit attribution. Keep the default unless a specific service or operator identity should be recorded. |
| `arguments` | array | No | Signal arguments as ordinary JSON values. Each value is encoded as one Temporal json/plain Payload. Mutually exclusive with raw_payloads. |
| `signal_name` | string | Yes | Workflow-author-defined Signal name sent to every selected Workflow. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host. |
| `raw_payloads` | array | No | Exact custom-codec Signal Payloads. Mutually exclusive with arguments. |
| `visibility_query` | string | No | SQL-like filter scoped to this Namespace. Attribute names are case-sensitive. Use =, !=, >, >=, <, <=, IN (...), BETWEEN ... AND ..., IS NULL, IS NOT NULL, STARTS_WITH, AND, OR, and parentheses. Quote strings and RFC3339 timestamps with single or double quotes; wrap custom attribute names containing non-alphanumeric characters in backticks. Common attributes include WorkflowId, WorkflowType, ExecutionStatus, StartTime, CloseTime, ExecutionTime, RunId, and TaskQueue. Temporal Cloud does not support ORDER BY. Example: `ExecutionStatus = 'Running' AND WorkflowType = 'OrderWorkflow'`. Before starting, call COUNT_WORKFLOWS with this exact query and obtain approval for the observed scope. Its count is approximate and matches can change, so the preview is not a hard upper bound. Mutually exclusive with target_executions. |
| `target_executions` | array | No | Explicit non-empty Workflow targets. Use these instead of a Visibility query when the list length must be a hard cardinality bound. Mutually exclusive with visibility_query. |
| `max_operations_per_second` | number | No | Positive processing-rate ceiling. Temporal may enforce a lower rate. This limits throughput, not the number of matching Workflows, and is not a cardinality safety bound. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Batch Terminate Workflows

**Slug:** `TEMPORAL_BATCH_TERMINATE_WORKFLOWS`

WARNING: 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 observed scope; its approximate count is not a hard upper bound because matches can change. Use explicit target_executions when a fixed cardinality bound is required. A stable job_id identifies this operation but does not make retries idempotently successful. After an ambiguous timeout, a retry may return 409 because Temporal rejects duplicate job IDs. Call DESCRIBE_BATCH_OPERATION with the same namespace_id and job_id to reconcile before creating any other batch operation. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Stable ID that identifies this batch operation. Temporal rejects duplicate job IDs instead of treating a retry as idempotent success. After an ambiguous timeout, a retry with this ID may return a conflict even if the operation started; call DESCRIBE_BATCH_OPERATION with the same namespace_id and job_id to reconcile before creating any other batch operation. |
| `reason` | string | Yes | Human-readable audit reason recorded for this batch operation. |
| `details` | array | No | Optional termination details as ordinary JSON values. Each value is encoded as one Temporal json/plain Payload. Mutually exclusive with raw_payloads. |
| `identity` | string | No | Optional caller name recorded by Temporal for audit attribution. Keep the default unless a specific service or operator identity should be recorded. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host. |
| `raw_payloads` | array | No | Optional exact custom-codec termination Payloads. Mutually exclusive with details. |
| `visibility_query` | string | No | SQL-like filter scoped to this Namespace. Attribute names are case-sensitive. Use =, !=, >, >=, <, <=, IN (...), BETWEEN ... AND ..., IS NULL, IS NOT NULL, STARTS_WITH, AND, OR, and parentheses. Quote strings and RFC3339 timestamps with single or double quotes; wrap custom attribute names containing non-alphanumeric characters in backticks. Common attributes include WorkflowId, WorkflowType, ExecutionStatus, StartTime, CloseTime, ExecutionTime, RunId, and TaskQueue. Temporal Cloud does not support ORDER BY. Example: `ExecutionStatus = 'Running' AND WorkflowType = 'OrderWorkflow'`. Before starting, call COUNT_WORKFLOWS with this exact query and obtain approval for the observed scope. Its count is approximate and matches can change, so the preview is not a hard upper bound. Mutually exclusive with target_executions. |
| `target_executions` | array | No | Explicit non-empty Workflow targets. Use these instead of a Visibility query when the list length must be a hard cardinality bound. Mutually exclusive with visibility_query. |
| `max_operations_per_second` | number | No | Positive processing-rate ceiling. Temporal may enforce a lower rate. This limits throughput, not the number of matching Workflows, and is not a cardinality safety bound. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Batch Update Workflow Options

**Slug:** `TEMPORAL_BATCH_UPDATE_WORKFLOW_OPTIONS`

Update 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 query with COUNT_WORKFLOWS and obtain approval for the observed scope; its approximate count is not a hard upper bound because matches can change. Use explicit target_executions when a fixed cardinality bound is required. A stable job_id identifies this operation but does not make retries idempotently successful. After an ambiguous timeout, a retry may return 409 because Temporal rejects duplicate job IDs. Call DESCRIBE_BATCH_OPERATION with the same namespace_id and job_id to reconcile before creating any other batch operation. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Stable ID that identifies this batch operation. Temporal rejects duplicate job IDs instead of treating a retry as idempotent success. After an ambiguous timeout, a retry with this ID may return a conflict even if the operation started; call DESCRIBE_BATCH_OPERATION with the same namespace_id and job_id to reconcile before creating any other batch operation. |
| `reason` | string | Yes | Human-readable audit reason recorded for this batch operation. |
| `identity` | string | No | Optional caller name recorded by Temporal for audit attribution. Keep the default unless a specific service or operator identity should be recorded. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host. |
| `visibility_query` | string | No | SQL-like filter scoped to this Namespace. Attribute names are case-sensitive. Use =, !=, >, >=, <, <=, IN (...), BETWEEN ... AND ..., IS NULL, IS NOT NULL, STARTS_WITH, AND, OR, and parentheses. Quote strings and RFC3339 timestamps with single or double quotes; wrap custom attribute names containing non-alphanumeric characters in backticks. Common attributes include WorkflowId, WorkflowType, ExecutionStatus, StartTime, CloseTime, ExecutionTime, RunId, and TaskQueue. Temporal Cloud does not support ORDER BY. Example: `ExecutionStatus = 'Running' AND WorkflowType = 'OrderWorkflow'`. Before starting, call COUNT_WORKFLOWS with this exact query and obtain approval for the observed scope. Its count is approximate and matches can change, so the preview is not a hard upper bound. Mutually exclusive with target_executions. |
| `workflow_options` | object | Yes | Typed Workflow options and exact top-level update mask for every target. |
| `target_executions` | array | No | Explicit non-empty Workflow targets. Use these instead of a Visibility query when the list length must be a hard cardinality bound. Mutually exclusive with visibility_query. |
| `max_operations_per_second` | number | No | Positive processing-rate ceiling. Temporal may enforce a lower rate. This limits throughput, not the number of matching Workflows, and is not a cardinality safety bound. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Workflow

**Slug:** `TEMPORAL_CANCEL_WORKFLOW`

Irreversibly 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 ignore cancellation depending on its code. A request for an already-closed Workflow succeeds. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reason` | string | No | Optional human-readable cancellation reason recorded in Event History. |
| `run_id` | string | No | Specific run ID to cancel; omit to target the current run. |
| `identity` | string | No | Caller identity recorded in Event History. |
| `request_id` | string | No | Stable idempotency ID to reuse when retrying the same cancellation request. |
| `workflow_id` | string | Yes | Application-defined Workflow ID whose execution should be canceled. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |
| `first_execution_run_id` | string | No | Optional execution-chain guard. Temporal rejects the request unless the target run belongs to the chain that began with this run ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Count Schedules

**Slug:** `TEMPORAL_COUNT_SCHEDULES`

Return an approximate count of Temporal Schedules matching a Schedule Visibility query, including grouped counts when requested. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Optional SQL-like Temporal Schedule Visibility query. Attribute names are case-sensitive; quote string values and combine predicates with AND or OR. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Count Workflows

**Slug:** `TEMPORAL_COUNT_WORKFLOWS`

Return an approximate count of Workflow Executions matching a Temporal Visibility query, including supported grouped counts. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | SQL-like filter scoped to this Namespace. Attribute names are case-sensitive. Use =, !=, >, >=, <, <=, IN (...), BETWEEN ... AND ..., IS NULL, IS NOT NULL, STARTS_WITH, AND, OR, and parentheses. Quote strings and RFC3339 timestamps with single or double quotes; wrap custom attribute names containing non-alphanumeric characters in backticks. Common attributes include WorkflowId, WorkflowType, ExecutionStatus, StartTime, CloseTime, ExecutionTime, RunId, and TaskQueue. Temporal Cloud does not support ORDER BY. Example: `ExecutionStatus = 'Running' AND WorkflowType = 'OrderWorkflow'`. This count endpoint additionally supports `GROUP BY ExecutionStatus` only; counts are approximate. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix; this deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create and Apply Workflow Rule

**Slug:** `TEMPORAL_CREATE_AND_APPLY_WORKFLOW_RULE`

Create 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 irreversible operational effects. Use request_id for idempotent retries. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `spec` | object | Yes | Rule ID, Activity trigger, Workflow filter, actions, and expiration. |
| `identity` | string | No | Identity of the actor creating the rule; stored with the rule. |
| `request_id` | string | No | Caller-generated request ID used by Temporal to de-duplicate retries. |
| `description` | string | No | Human-readable description stored with the rule. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Export Sink

**Slug:** `TEMPORAL_CREATE_EXPORT_SINK`

Create 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 ongoing schedule and may incur storage costs. Validate the destination first, use a disposable sink for testing, and arrange teardown.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `spec` | object | Yes | Export sink name, enabled state, and exactly one of s3, gcs, or azure_blob. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including its account suffix. |
| `async_operation_id` | string | No | Optional caller-chosen idempotency ID. Reuse it only when retrying this same creation request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Schedule

**Slug:** `TEMPORAL_CREATE_SCHEDULE`

Create 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 idempotent retries. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `memo` | object | No | Unindexed Schedule Memo values encoded as Temporal json/plain Payloads. |
| `state` | object | No | Paused state, notes, and optional action limit for the Schedule. |
| `jitter` | string | No | Maximum random positive delay applied to each matching schedule time. |
| `end_time` | string | No | Inclusive RFC 3339 time after which no scheduled action may start. |
| `identity` | string | No | Caller identity recorded in Schedule history. |
| `policies` | object | No | Overlap, catchup, failure, and Workflow ID policies for the Schedule. |
| `priority` | object | No | Advanced Temporal Priority protobuf JSON for each started Workflow. |
| `arguments` | array | No | Workflow arguments encoded as json/plain Payloads; mutually exclusive with raw_payloads. |
| `calendars` | array | No | Labeled calendar expressions; Temporal compiles these into structured calendars. |
| `intervals` | array | No | Fixed interval specifications combined with any other supplied timing sources. |
| `request_id` | string | No | Idempotency ID; reuse it only when retrying the same intended mutation. |
| `start_time` | string | No | Inclusive RFC 3339 time before which no scheduled action may start. |
| `task_queue` | string | Yes | Task Queue polled by a Worker that supports workflow_type. |
| `schedule_id` | string | Yes | Application-defined Schedule ID unique within the Namespace. |
| `workflow_id` | string | No | Optional Workflow ID used by each scheduled start. Omit it to let Temporal generate a unique Workflow ID. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix, for example 'payments.a1b2c'. |
| `raw_payloads` | array | No | Exact protobuf-JSON Payloads for custom codecs; mutually exclusive with arguments. |
| `retry_policy` | object | No | Server-side retry policy applied to each scheduled Workflow. |
| `initial_patch` | object | No | Optional Temporal SchedulePatch protobuf JSON applied atomically at creation, for example triggerImmediately, backfillRequest, pause, or unpause. |
| `timezone_data` | string | No | Optional base64 TZif timezone definition used instead of server timezone data. |
| `timezone_name` | string | No | IANA timezone used to interpret cron expressions, such as 'America/Chicago'. |
| `user_metadata` | object | No | Advanced Temporal UserMetadata protobuf JSON for each started Workflow. |
| `workflow_memo` | object | No | Unindexed Memo values attached to each Workflow started by the Schedule. |
| `workflow_type` | string | Yes | Registered Workflow type name implemented by a compatible Worker. |
| `cron_expressions` | array | No | Temporal cron expressions combined with any other supplied timing sources. |
| `workflow_headers` | object | No | Workflow header fields encoded as Temporal json/plain Payloads. |
| `exclude_calendars` | array | No | Deprecated labeled calendar expressions whose matching times are excluded. |
| `search_attributes` | object | No | Registered Schedule Search Attribute values encoded as indexed Payloads. |
| `versioning_override` | object | No | Advanced Temporal VersioningOverride protobuf JSON for each started Workflow. |
| `structured_calendars` | array | No | Programmatic calendar ranges whose matches are included in the Schedule. |
| `workflow_run_timeout` | string | No | Maximum time for one Workflow run as a positive protobuf duration. |
| `workflow_task_timeout` | string | No | Maximum time for one Workflow Task as a positive protobuf duration. |
| `workflow_execution_timeout` | string | No | Maximum total Workflow execution time as a positive protobuf duration. |
| `workflow_search_attributes` | object | No | Registered Search Attribute values attached to each started Workflow. |
| `exclude_structured_calendars` | array | No | Programmatic calendar ranges whose matching times are excluded. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Workflow Rule

**Slug:** `TEMPORAL_CREATE_WORKFLOW_RULE`

Create 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 separate intent. Use request_id for idempotent retries. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `spec` | object | Yes | Rule ID, Activity trigger, Workflow filter, actions, and expiration. |
| `identity` | string | No | Identity of the actor creating the rule; stored with the rule. |
| `request_id` | string | No | Caller-generated request ID used by Temporal to de-duplicate retries. |
| `description` | string | No | Human-readable description stored with the rule. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Export Sink

**Slug:** `TEMPORAL_DELETE_EXPORT_SINK`

Delete 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 storage remain there and must be managed separately. Confirm the Namespace, sink name, and current resource version before calling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sink_name` | string | Yes | Export sink name to delete. WARNING: deletion stops future Workflow History exports from this sink and cannot be undone; files already exported to external storage are not deleted. |
| `namespace_id` | string | Yes | Full Cloud Namespace ID containing the export sink. Verify this Namespace and sink identify the intended test or disposable export configuration. |
| `resource_version` | string | Yes | Current resourceVersion from GET_EXPORT_SINK. Re-read the sink immediately before deletion to avoid deleting a configuration that changed. |
| `async_operation_id` | string | No | Optional caller-chosen idempotency ID. Reuse it only when retrying this exact export-sink deletion request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Namespace

**Slug:** `TEMPORAL_DELETE_NAMESPACE`

Permanently 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 confirming its full ID, contents, latest resource version, and that deletion protection is disabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `namespace_id` | string | Yes | Full Cloud Namespace ID from DESCRIBE_NAMESPACE, including its account suffix. WARNING: verify this identifies a disposable Namespace; deletion permanently destroys the Namespace and all of its data. |
| `resource_version` | string | Yes | Current resourceVersion from DESCRIBE_NAMESPACE. Re-check it immediately before deletion to guard against deleting a Namespace that changed. |
| `async_operation_id` | string | No | Optional caller-chosen idempotency ID. Reuse it only when retrying this exact deletion request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Schedule

**Slug:** `TEMPORAL_DELETE_SCHEDULE`

Permanently 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. Confirm the Namespace and Schedule ID before calling. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identity` | string | No | Caller identity recorded by Temporal. Omit to use composio. |
| `schedule_id` | string | Yes | Application-defined ID of the Schedule to permanently delete. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Workflow Rule

**Slug:** `TEMPORAL_DELETE_WORKFLOW_RULE`

Permanently 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 and rule ID before calling. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rule_id` | string | Yes | User-specified ID of the Workflow Rule to permanently delete. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Describe Batch Operation

**Slug:** `TEMPORAL_DESCRIBE_BATCH_OPERATION`

Return progress, state, selection query, type, and failure counts for one batch operation in an authorized Temporal Cloud Namespace. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Batch job ID returned by LIST_BATCH_OPERATIONS or supplied when the batch started. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Describe Namespace

**Slug:** `TEMPORAL_DESCRIBE_NAMESPACE`

Return one Temporal Cloud Namespace's configuration, resource version, routing endpoints, state, limits, and capacity. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Describe Schedule

**Slug:** `TEMPORAL_DESCRIBE_SCHEDULE`

Return 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 intended fields and guard against concurrent changes. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `schedule_id` | string | Yes | Application-defined ID of the Schedule to describe. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Describe Workflow

**Slug:** `TEMPORAL_DESCRIBE_WORKFLOW`

Return 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 Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | No | Specific Workflow run ID. Omit it to describe the current run for the Workflow ID. |
| `workflow_id` | string | Yes | Application-defined Workflow ID, sent unchanged in the request path. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix; this validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Describe Workflow Rule

**Slug:** `TEMPORAL_DESCRIBE_WORKFLOW_RULE`

Return one configured Temporal Workflow Rule, including its trigger, Visibility query, actions, expiration, creation metadata, and description. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rule_id` | string | Yes | User-specified ID of the Workflow Rule to describe. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Fail Over Namespace Region

**Slug:** `TEMPORAL_FAILOVER_NAMESPACE_REGION`

Switch 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 documented rollback or failback plan before calling it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `region` | string | Yes | Configured replica region ID to make active. This failover disrupts current Namespace routing while it completes. |
| `namespace_id` | string | Yes | Full multi-region Cloud Namespace ID, including its account suffix. |
| `async_operation_id` | string | No | Optional caller-chosen idempotency ID. Reuse it only when retrying this exact failover. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Async Operation

**Slug:** `TEMPORAL_GET_ASYNC_OPERATION`

Return the current state and failure details of a Temporal Cloud asynchronous operation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `async_operation_id` | string | Yes | Operation ID returned by a Namespace, export-sink, access, failover, or Project mutation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Export Sink

**Slug:** `TEMPORAL_GET_EXPORT_SINK`

Return one Temporal Cloud Workflow History export sink, including its resource version, destination configuration, state, and health. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sink_name` | string | Yes | Name of the Workflow History export sink to return. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Namespace Capacity

**Slug:** `TEMPORAL_GET_NAMESPACE_CAPACITY`

Return a Temporal Cloud Namespace's capacity mode, available limits, and seven-day actions-per-second statistics. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Cloud Region

**Slug:** `TEMPORAL_GET_REGION`

Return details for one Temporal Cloud region, including its cloud provider, provider-specific identifier, and human-readable location.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `region_id` | string | Yes | Temporal Cloud region ID to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Workflow History

**Slug:** `TEMPORAL_GET_WORKFLOW_HISTORY`

Return one page of a Temporal Workflow Execution's Event History in forward or reverse order. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | No | Specific Workflow run ID; omit to inspect the current run. |
| `direction` | string ("FORWARD" | "REVERSE") | No | Event order: FORWARD for chronological or REVERSE for newest first. |
| `page_size` | integer | No | Maximum history events to return in this page. |
| `next_cursor` | string | No | Opaque base64 history cursor returned by the previous call. Continue with the same Namespace, Workflow, run, direction, and filters. |
| `workflow_id` | string | Yes | Application-defined Workflow ID whose Event History to return. |
| `event_filter` | string ("HISTORY_EVENT_FILTER_TYPE_ALL_EVENT" | "HISTORY_EVENT_FILTER_TYPE_CLOSE_EVENT") | No | Forward only: return all history events or only the close event. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host. |
| `skip_archival` | boolean | No | Forward only: do not retrieve archived Event History. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Archived Workflows

**Slug:** `TEMPORAL_LIST_ARCHIVED_WORKFLOWS`

Return 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; the probed Namespace returned HTTP 403 even with inherited Namespace Admin access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | SQL-like filter scoped to this Namespace. Attribute names are case-sensitive. Use =, !=, >, >=, <, <=, IN (...), BETWEEN ... AND ..., IS NULL, IS NOT NULL, STARTS_WITH, AND, OR, and parentheses. Quote strings and RFC3339 timestamps with single or double quotes; wrap custom attribute names containing non-alphanumeric characters in backticks. Common attributes include WorkflowId, WorkflowType, ExecutionStatus, StartTime, CloseTime, ExecutionTime, RunId, and TaskQueue. Temporal Cloud does not support ORDER BY. Example: `ExecutionStatus = 'Running' AND WorkflowType = 'OrderWorkflow'`. |
| `page_size` | integer | No | Maximum archived Workflow Executions to return in this page. |
| `next_cursor` | string | No | Opaque base64 cursor returned by a previous call; omit for the first page. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix; this deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Batch Operations

**Slug:** `TEMPORAL_LIST_BATCH_OPERATIONS`

Return one page of batch operations in an authorized Temporal Cloud Namespace. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum batch operations to return in this page. |
| `next_cursor` | string | No | Opaque base64 cursor returned by a previous call. Omit for the first page and pass it back unchanged to continue. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Export Sinks

**Slug:** `TEMPORAL_LIST_EXPORT_SINKS`

Return one page of Workflow History export sinks configured on a Temporal Cloud Namespace. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum export sinks to return in this page (1-1000). |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Namespace Assignments

**Slug:** `TEMPORAL_LIST_NAMESPACE_ASSIGNMENTS`

Return one page of users, User Groups, or Service Accounts assigned to a Temporal Cloud Namespace. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum assignments to return in this page (1-1000). |
| `next_cursor` | string | No | Exact cursor returned by a previous call for the same principal_type; omit for the first page. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. |
| `principal_type` | string ("USER" | "USER_GROUP" | "SERVICE_ACCOUNT") | Yes | Assignment collection to list: USER, USER_GROUP, or SERVICE_ACCOUNT. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Namespaces

**Slug:** `TEMPORAL_LIST_NAMESPACES`

Return one page of Temporal Cloud Namespaces visible to the API-key identity, optionally filtered by name or Project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional Namespace-name filter. |
| `page_size` | integer | No | Maximum Namespaces to return in this page (1-1000). |
| `project_id` | string | No | Optional Project ID filter. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Cloud Regions

**Slug:** `TEMPORAL_LIST_REGIONS`

List currently available Temporal Cloud regions for Namespace placement.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Schedule Matching Times

**Slug:** `TEMPORAL_LIST_SCHEDULE_MATCHING_TIMES`

List times within a required start-to-end range that match one Temporal Schedule's timing specification. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_time` | string | Yes | Required RFC 3339 end of the time range to evaluate. |
| `start_time` | string | Yes | Required RFC 3339 start of the time range to evaluate. |
| `schedule_id` | string | Yes | Application-defined ID of the Schedule to evaluate. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Schedules

**Slug:** `TEMPORAL_LIST_SCHEDULES`

Return one filtered page of Temporal Schedules in an authorized Temporal Cloud Namespace. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Optional SQL-like Temporal Schedule Visibility query. Attribute names are case-sensitive; quote string values and combine predicates with AND or OR. |
| `page_size` | integer | No | Maximum Schedules to return in this page. |
| `next_cursor` | string | No | Opaque base64 cursor returned by a previous call. Omit for the first page and pass it back unchanged to continue. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workflow Rules

**Slug:** `TEMPORAL_LIST_WORKFLOW_RULES`

Return one page of Workflow Rules configured for an authorized Temporal Cloud Namespace. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque base64 cursor returned by a previous call. Omit for the first page and pass it back unchanged to continue. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workflows

**Slug:** `TEMPORAL_LIST_WORKFLOWS`

Search one page of Workflow Executions in an authorized Temporal Cloud Namespace using Temporal Visibility query syntax. Requires Namespace Read access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | SQL-like filter scoped to this Namespace. Attribute names are case-sensitive. Use =, !=, >, >=, <, <=, IN (...), BETWEEN ... AND ..., IS NULL, IS NOT NULL, STARTS_WITH, AND, OR, and parentheses. Quote strings and RFC3339 timestamps with single or double quotes; wrap custom attribute names containing non-alphanumeric characters in backticks. Common attributes include WorkflowId, WorkflowType, ExecutionStatus, StartTime, CloseTime, ExecutionTime, RunId, and TaskQueue. Temporal Cloud does not support ORDER BY. Example: `ExecutionStatus = 'Running' AND WorkflowType = 'OrderWorkflow'`. |
| `page_size` | integer | No | Maximum Workflow Executions to return in this page. |
| `next_cursor` | string | No | Opaque base64 cursor returned by a previous call; omit for the first page. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Move Namespace To Project

**Slug:** `TEMPORAL_MOVE_NAMESPACE_TO_PROJECT`

Move 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 required connectivity rules, and obtain explicit approval before calling it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `connectivity` | object | Yes | Destination connectivity policy. Set exactly one of rule_ids or unrestricted=true. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. |
| `resource_version` | string | Yes | Current Namespace resourceVersion from DESCRIBE_NAMESPACE; stale versions are rejected. |
| `async_operation_id` | string | No | Optional caller-chosen idempotency ID. Reuse it only when retrying this same move. |
| `destination_project_id` | string | Yes | Project ID that will own the Namespace after the move. |
| `expected_source_project_id` | string | Yes | Current Project ID used as a concurrency guard; the move fails if it no longer matches. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Patch Schedule

**Slug:** `TEMPORAL_PATCH_SCHEDULE`

Apply 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 application Workflows and may cause arbitrary external side effects. Use request_id for idempotent retries. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identity` | string | No | Caller identity recorded by Temporal for this patch. |
| `pause_note` | string | No | Pause automatic Schedule actions and store this explanatory note. |
| `request_id` | string | No | Idempotency ID; reuse it only when retrying this exact patch intent. |
| `schedule_id` | string | Yes | Application-defined ID of the Schedule to patch. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |
| `unpause_note` | string | No | Resume automatic Schedule actions and store this explanatory note. |
| `backfill_ranges` | array | No | Historical ranges to evaluate immediately. Every matching time may start a Workflow and cause application side effects. |
| `trigger_immediately` | object | No | Trigger one Schedule action immediately. This starts application Workflow code and may cause arbitrary external side effects. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Pause Workflow

**Slug:** `TEMPORAL_PAUSE_WORKFLOW`

Pause 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, and rejects Queries and Updates; an executing Workflow Task may still complete and server-side events continue. This operational side effect can halt business processing. Always call UNPAUSE_WORKFLOW during teardown, even if a later step fails. Requires Namespace Write access. This Temporal API is experimental.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reason` | string | No | Optional human-readable reason for pausing the Workflow Execution. |
| `run_id` | string | No | Specific run ID to pause; omit to target the current run. |
| `identity` | string | No | Caller identity recorded in Event History. |
| `request_id` | string | No | Unique idempotency ID, typically a UUIDv4. Reuse it only when retrying the same pause request. |
| `workflow_id` | string | Yes | Application-defined Workflow ID whose execution should be paused. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Workflow

**Slug:** `TEMPORAL_QUERY_WORKFLOW`

Run 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | No | Specific Workflow run ID. Omit it to query the current run. |
| `arguments` | array | No | Query arguments as ordinary JSON values. Each value is encoded as a Temporal json/plain Payload. Mutually exclusive with raw_payloads. |
| `query_type` | string | Yes | Workflow-author-defined Query handler name. |
| `workflow_id` | string | Yes | Application-defined Workflow ID whose Query handler will run. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix, for example 'payments.a1b2c'. It deterministically selects the Namespace's web.tmprl.cloud host; a name without the suffix is rejected. |
| `raw_payloads` | array | No | Exact protobuf-JSON Payloads for a custom codec or non-JSON data. metadata and data byte values must be base64. Mutually exclusive with arguments. |
| `reject_condition` | string ("QUERY_REJECT_CONDITION_UNSPECIFIED" | "QUERY_REJECT_CONDITION_NONE" | "QUERY_REJECT_CONDITION_NOT_OPEN" | "QUERY_REJECT_CONDITION_NOT_COMPLETED_CLEANLY") | No | Condition under which Temporal rejects the Query based on Workflow Execution status. Omit it for Temporal's default behavior. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Register Namespace

**Slug:** `TEMPORAL_REGISTER_NAMESPACE`

Create 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 deleted. Use a unique disposable name for testing and arrange teardown only after creation completes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Immutable Namespace name without the account suffix. |
| `tags` | object | No | Namespace tags. Supplying tags requires Global Admin or Account Owner. |
| `replicas` | array | Yes | One or two immutable replica placements using region IDs returned by LIST_REGIONS. Supplying two replicas creates a global Namespace regardless of high_availability settings. |
| `mtls_auth` | object | No | Optional current Cloud API mTLS authentication configuration. |
| `project_id` | string | No | Project in which to create the Namespace; omit for the default Project. |
| `codec_server` | object | No | Optional codec-server configuration used by the Temporal Cloud UI. |
| `capacity_spec` | object | No | Optional current Cloud API on-demand or provisioned capacity configuration. |
| `retention_days` | integer | No | History retention in days for new Workflow Executions; affects storage cost. |
| `high_availability` | object | No | Optional failover and passive-poller behavior for a two-replica global Namespace. Replica count, not this object, determines whether the Namespace is global. |
| `search_attributes` | object | No | Custom Search Attribute names and types. Created attributes cannot be deleted later. |
| `async_operation_id` | string | No | Stable caller-chosen idempotency ID; omit to let Temporal generate one. |
| `deletion_protection` | boolean | No | Protect the Namespace from accidental deletion. Defaults to enabled. |
| `api_key_auth_enabled` | boolean | No | Enable API-key authentication so this toolkit can access the Namespace. |
| `connectivity_rule_ids` | array | No | Private Connectivity rule IDs to apply to the Namespace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Namespace Access

**Slug:** `TEMPORAL_REMOVE_NAMESPACE_ACCESS`

Remove 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 access or lock out the selected identity; verify inherited access and never remove the caller's or sole administrator's access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including its account suffix. |
| `principal_id` | string | Yes | Temporal Cloud user, user-group, or service-account ID matching principal_type. |
| `principal_type` | string ("USER" | "USER_GROUP" | "SERVICE_ACCOUNT") | Yes | Principal selector: USER, USER_GROUP, or SERVICE_ACCOUNT. This selects the matching fixed Temporal endpoint. |
| `resource_version` | string | Yes | Current resourceVersion of the selected user, group, or service account. Obtain it from that principal's current get/list response; this is not the Namespace resource version. |
| `async_operation_id` | string | No | Optional caller-chosen idempotency ID. Reuse it only when retrying this exact removal. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Rename Custom Search Attribute

**Slug:** `TEMPORAL_RENAME_CUSTOM_SEARCH_ATTRIBUTE`

Rename 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 that reference the old name. Verify all consumers and use the latest Namespace resource version before starting the rename.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `new_name` | string | Yes | New name for the custom Search Attribute. Update every dependent Visibility query and dashboard to use this name. |
| `namespace_id` | string | Yes | Full Cloud Namespace ID containing the custom Search Attribute. |
| `existing_name` | string | Yes | Current name of the custom Search Attribute to rename. |
| `resource_version` | string | Yes | Current Namespace resourceVersion from DESCRIBE_NAMESPACE; stale versions are rejected. |
| `async_operation_id` | string | No | Optional caller-chosen idempotency ID. Reuse it only when retrying this exact rename. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Replace Workflow

**Slug:** `TEMPORAL_REPLACE_WORKFLOW`

Replace 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 replacement. This may interrupt in-flight work, and the new Workflow may cause arbitrary external side effects. Use only when termination is explicitly intended, and use request_id for idempotent retries. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `memo` | object | No | Unindexed Memo values encoded individually as Temporal json/plain Payloads. |
| `identity` | string | No | Caller identity recorded in the Workflow Event History. |
| `arguments` | array | No | Workflow arguments as ordinary JSON values. Each value is encoded as a Temporal json/plain Payload. Mutually exclusive with raw_payloads. |
| `request_id` | string | No | Idempotency ID for this start request, typically a UUIDv4. Reuse the same value only when retrying the same intended start. |
| `task_queue` | string | Yes | Task Queue polled by a Worker that supports workflow_type. |
| `workflow_id` | string | Yes | Application-defined Workflow ID. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix, for example 'payments.a1b2c'. It deterministically selects the Namespace's web.tmprl.cloud host; a name without the suffix is rejected. |
| `raw_payloads` | array | No | Exact protobuf-JSON Payloads for a custom codec. metadata and data byte values must be base64. Mutually exclusive with arguments. |
| `retry_policy` | object | No | Optional server-side Workflow retry policy. |
| `cron_schedule` | string | No | Optional cron expression. Prefer Temporal Schedules for new designs. |
| `workflow_type` | string | Yes | Registered Workflow type name implemented by a compatible Worker. |
| `search_attributes` | object | No | Values for registered Search Attributes, encoded individually as indexed Temporal json/plain Payloads. |
| `workflow_run_timeout` | string | No | Maximum time for one Workflow run as a protobuf duration such as '3600s'. |
| `workflow_task_timeout` | string | No | Maximum time for one Workflow Task as a protobuf duration such as '10s'. |
| `workflow_id_reuse_policy` | string ("WORKFLOW_ID_REUSE_POLICY_UNSPECIFIED" | "WORKFLOW_ID_REUSE_POLICY_ALLOW_DUPLICATE" | "WORKFLOW_ID_REUSE_POLICY_ALLOW_DUPLICATE_FAILED_ONLY" | "WORKFLOW_ID_REUSE_POLICY_REJECT_DUPLICATE") | No | Policy for reusing this Workflow ID after a closed execution. |
| `workflow_execution_timeout` | string | No | Maximum total execution time across retries and continue-as-new as a protobuf duration, for example '3600s'; units such as '1h' are invalid. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reset Workflow

**Slug:** `TEMPORAL_RESET_WORKFLOW`

WARNING: 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 and external side effects. Verify the source run, event ID, and reapply policy before calling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reason` | string | Yes | Human-readable reason recorded for this irreversible Workflow reset. |
| `run_id` | string | Yes | Exact source run ID containing the reset event. Temporal terminates the current run even when this identifies an earlier run in the chain. |
| `request_id` | string | No | Stable request ID used by Temporal to deduplicate resets. Reuse it only when retrying this exact reset intent. |
| `workflow_id` | string | Yes | Application-defined Workflow ID whose execution chain will be reset. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host. |
| `reset_reapply_type` | string ("RESET_REAPPLY_TYPE_UNSPECIFIED" | "RESET_REAPPLY_TYPE_SIGNAL" | "RESET_REAPPLY_TYPE_NONE" | "RESET_REAPPLY_TYPE_ALL_ELIGIBLE") | No | Deprecated legacy policy for events after the reset point. Temporal defaults this field to RESET_REAPPLY_TYPE_SIGNAL; prefer reset_reapply_exclude_types. |
| `reset_reapply_exclude_types` | array | No | Event categories to exclude when reapplying eligible events after the reset point. CANCEL_REQUEST is deprecated and unimplemented by Temporal. |
| `workflow_task_finish_event_id` | string | Yes | Positive int64 event ID in the source run at which to reset. It must identify a WORKFLOW_TASK_COMPLETED, WORKFLOW_TASK_TIMED_OUT, WORKFLOW_TASK_FAILED, or WORKFLOW_TASK_STARTED event. Decimal strings are recommended to preserve all int64 values exactly in JSON. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Namespace Access

**Slug:** `TEMPORAL_SET_NAMESPACE_ACCESS`

Set 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 lower permission may lock out the caller or the Namespace's sole admin. Requires Namespace Admin.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `permission` | string ("PERMISSION_ADMIN" | "PERMISSION_WRITE" | "PERMISSION_READ") | Yes | Exact direct Namespace permission to set: ADMIN, WRITE, or READ. This replaces the principal's current direct permission; choosing a lower permission may lock out the caller or the Namespace's sole admin. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including its account suffix. |
| `principal_id` | string | Yes | Temporal Cloud user, user-group, or service-account ID matching principal_type. |
| `principal_type` | string ("USER" | "USER_GROUP" | "SERVICE_ACCOUNT") | Yes | Principal kind: USER, USER_GROUP, or SERVICE_ACCOUNT. This selects the matching Temporal endpoint. |
| `resource_version` | string | Yes | Current resourceVersion of the selected user, group, or service account. Obtain it from that principal's current get/list response; this is not the Namespace resource version. |
| `async_operation_id` | string | No | Optional caller-chosen idempotency ID. Reuse it only when retrying this exact access change. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Signal With Start Workflow

**Slug:** `TEMPORAL_SIGNAL_WITH_START_WORKFLOW`

Atomically 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. The TERMINATE_EXISTING conflict policy and deprecated TERMINATE_IF_RUNNING reuse policy can terminate a running execution before starting and signaling its replacement.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identity` | string | No | Caller identity recorded in Workflow Event History. |
| `request_id` | string | No | Stable idempotency ID. Reuse it only when retrying the same signal-with-start intent. |
| `task_queue` | string | Yes | Task Queue polled by a compatible Worker if a new execution is started. |
| `signal_name` | string | Yes | Workflow-author-defined Signal handler name. |
| `workflow_id` | string | Yes | Application-defined Workflow ID to signal or atomically start. |
| `namespace_id` | string | Yes | Full lowercase Cloud Namespace ID including its account suffix, for example payments.a1b2c; it deterministically selects the Namespace web host. |
| `start_options` | object | No | Optional settings applied only when Temporal starts a new Workflow Execution. |
| `workflow_type` | string | Yes | Registered Workflow type used only if a new execution must be started. |
| `signal_arguments` | array | No | Signal arguments as ordinary JSON values. Each list element becomes one Temporal json/plain Payload; use signal_raw_payloads only for custom codecs. |
| `workflow_arguments` | array | No | Workflow start arguments as ordinary JSON values. Each list element becomes one Temporal json/plain Payload. |
| `signal_raw_payloads` | array | No | Exact signal Payloads for custom codecs; mutually exclusive with signal_arguments. |
| `workflow_raw_payloads` | array | No | Exact Workflow start Payloads for custom codecs; mutually exclusive with workflow_arguments. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Signal Workflow

**Slug:** `TEMPORAL_SIGNAL_WORKFLOW`

Send 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 successful response only confirms acceptance, not handler completion. Use request_id to make retries idempotent. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | No | Specific Workflow run ID to signal. Omit it to target the current run for workflow_id. |
| `identity` | string | No | Caller identity recorded in the Workflow Event History. |
| `arguments` | array | No | Signal arguments as ordinary JSON values. Each list element is encoded as one Temporal json/plain Payload. Mutually exclusive with raw_payloads. |
| `request_id` | string | No | Stable idempotency ID used by Temporal to deduplicate this Signal. Reuse it only when retrying the same intended Signal. |
| `signal_name` | string | Yes | Workflow-author-defined name of the registered Signal handler. |
| `workflow_id` | string | Yes | Application-defined Workflow ID of the running execution to signal. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix, for example 'payments.a1b2c'. It deterministically selects the Namespace's web.tmprl.cloud host; a name without the suffix is rejected. |
| `raw_payloads` | array | No | Exact Temporal Payloads for a custom codec. metadata and data byte values must be base64. Mutually exclusive with arguments. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start or Get Workflow

**Slug:** `TEMPORAL_START_OR_GET_WORKFLOW`

Start 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 existing execution. Starting a Workflow dispatches application code and may cause arbitrary external side effects. Use request_id for idempotent retries. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `memo` | object | No | Unindexed Memo values encoded individually as Temporal json/plain Payloads. |
| `identity` | string | No | Caller identity recorded in the Workflow Event History. |
| `arguments` | array | No | Workflow arguments as ordinary JSON values. Each value is encoded as a Temporal json/plain Payload. Mutually exclusive with raw_payloads. |
| `request_id` | string | No | Idempotency ID for this start request, typically a UUIDv4. Reuse the same value only when retrying the same intended start. |
| `task_queue` | string | Yes | Task Queue polled by a Worker that supports workflow_type. |
| `workflow_id` | string | Yes | Application-defined Workflow ID. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix, for example 'payments.a1b2c'. It deterministically selects the Namespace's web.tmprl.cloud host; a name without the suffix is rejected. |
| `raw_payloads` | array | No | Exact protobuf-JSON Payloads for a custom codec. metadata and data byte values must be base64. Mutually exclusive with arguments. |
| `retry_policy` | object | No | Optional server-side Workflow retry policy. |
| `cron_schedule` | string | No | Optional cron expression. Prefer Temporal Schedules for new designs. |
| `workflow_type` | string | Yes | Registered Workflow type name implemented by a compatible Worker. |
| `search_attributes` | object | No | Values for registered Search Attributes, encoded individually as indexed Temporal json/plain Payloads. |
| `workflow_run_timeout` | string | No | Maximum time for one Workflow run as a protobuf duration such as '3600s'. |
| `workflow_task_timeout` | string | No | Maximum time for one Workflow Task as a protobuf duration such as '10s'. |
| `workflow_id_reuse_policy` | string ("WORKFLOW_ID_REUSE_POLICY_UNSPECIFIED" | "WORKFLOW_ID_REUSE_POLICY_ALLOW_DUPLICATE" | "WORKFLOW_ID_REUSE_POLICY_ALLOW_DUPLICATE_FAILED_ONLY" | "WORKFLOW_ID_REUSE_POLICY_REJECT_DUPLICATE") | No | Policy for reusing this Workflow ID after a closed execution. |
| `workflow_execution_timeout` | string | No | Maximum total execution time across retries and continue-as-new as a protobuf duration, for example '3600s'; units such as '1h' are invalid. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start Workflow

**Slug:** `TEMPORAL_START_WORKFLOW`

Start 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 different conflict semantics are intended. This dispatches application code and may cause arbitrary external side effects. Use request_id for idempotent retries. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `memo` | object | No | Unindexed Memo values encoded individually as Temporal json/plain Payloads. |
| `identity` | string | No | Caller identity recorded in the Workflow Event History. |
| `arguments` | array | No | Workflow arguments as ordinary JSON values. Each value is encoded as a Temporal json/plain Payload. Mutually exclusive with raw_payloads. |
| `request_id` | string | No | Idempotency ID for this start request, typically a UUIDv4. Reuse the same value only when retrying the same intended start. |
| `task_queue` | string | Yes | Task Queue polled by a Worker that supports workflow_type. |
| `workflow_id` | string | Yes | Application-defined Workflow ID. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix, for example 'payments.a1b2c'. It deterministically selects the Namespace's web.tmprl.cloud host; a name without the suffix is rejected. |
| `raw_payloads` | array | No | Exact protobuf-JSON Payloads for a custom codec. metadata and data byte values must be base64. Mutually exclusive with arguments. |
| `retry_policy` | object | No | Optional server-side Workflow retry policy. |
| `cron_schedule` | string | No | Optional cron expression. Prefer Temporal Schedules for new designs. |
| `workflow_type` | string | Yes | Registered Workflow type name implemented by a compatible Worker. |
| `search_attributes` | object | No | Values for registered Search Attributes, encoded individually as indexed Temporal json/plain Payloads. |
| `workflow_run_timeout` | string | No | Maximum time for one Workflow run as a protobuf duration such as '3600s'. |
| `workflow_task_timeout` | string | No | Maximum time for one Workflow Task as a protobuf duration such as '10s'. |
| `workflow_id_reuse_policy` | string ("WORKFLOW_ID_REUSE_POLICY_UNSPECIFIED" | "WORKFLOW_ID_REUSE_POLICY_ALLOW_DUPLICATE" | "WORKFLOW_ID_REUSE_POLICY_ALLOW_DUPLICATE_FAILED_ONLY" | "WORKFLOW_ID_REUSE_POLICY_REJECT_DUPLICATE") | No | Policy for reusing this Workflow ID after a closed execution. |
| `workflow_execution_timeout` | string | No | Maximum total execution time across retries and continue-as-new as a protobuf duration, for example '3600s'; units such as '1h' are invalid. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Stop Batch Operation

**Slug:** `TEMPORAL_STOP_BATCH_OPERATION`

Request 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 changes remain in effect. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Running Temporal batch operation job ID to stop. |
| `reason` | string | Yes | Human-readable reason recorded for stopping the batch operation. |
| `identity` | string | No | Caller identity recorded by Temporal. Omit to use composio. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Terminate Workflow

**Slug:** `TEMPORAL_TERMINATE_WORKFLOW`

Immediately and irreversibly terminate one Temporal Workflow Execution. WARNING: termination bypasses cooperative cancellation and Workflow cleanup logic, so finally blocks, compensation, and pending work may not run. Use cancellation instead when the Workflow can clean up safely. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reason` | string | No | Optional termination reason recorded in Workflow Event History. |
| `run_id` | string | No | Specific run ID to terminate; omit to target the current run. |
| `details` | array | No | Termination detail values recorded in Event History. Each value is encoded as one Temporal json/plain Payload. Mutually exclusive with raw_details. |
| `identity` | string | No | Caller identity recorded in Workflow Event History. |
| `raw_details` | array | No | Exact protobuf-JSON termination Payloads for custom codecs or non-JSON data. metadata and data byte values must be base64. Mutually exclusive with details. |
| `workflow_id` | string | Yes | Application-defined Workflow ID whose execution will be terminated. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host; a Namespace name without the suffix is rejected. |
| `first_execution_run_id` | string | No | Optional execution-chain guard. Temporal rejects the request unless the target run belongs to the chain that began with this run ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Trigger Workflow Rule

**Slug:** `TEMPORAL_TRIGGER_WORKFLOW_RULE`

Trigger 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 destructive or arbitrary external side effects. Verify the Workflow and rule before calling; do not test against production or an unknown rule. A successful request can return applied=false when the rule conditions do not match. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | No | Specific run ID to target; omit to target the current run. |
| `rule_id` | string | Yes | ID of an existing configured Workflow Rule to evaluate and trigger. |
| `identity` | string | No | Caller identity recorded by Temporal for this rule trigger request. |
| `workflow_id` | string | Yes | Application-defined Workflow ID whose execution the rule should target. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unpause Workflow

**Slug:** `TEMPORAL_UNPAUSE_WORKFLOW`

Resume 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 external side effects. Use request_id for idempotent retries. This Temporal API is experimental and requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reason` | string | No | Optional human-readable reason for resuming the Workflow Execution. |
| `run_id` | string | No | Specific run ID to unpause; omit to target the current run. |
| `identity` | string | No | Caller identity recorded in Workflow Event History. |
| `request_id` | string | No | Unique idempotency ID, typically a UUIDv4. Reuse it only when retrying the same unpause request. |
| `workflow_id` | string | Yes | Application-defined Workflow ID of the paused execution to resume. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. This validated value deterministically selects its web.tmprl.cloud host. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Export Sink

**Slug:** `TEMPORAL_UPDATE_EXPORT_SINK`

Update 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 exports and may redirect or stop Workflow History delivery; already exported files are not moved or undone. Confirm the complete current specification, destination, and resourceVersion before calling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `spec` | object | Yes | Complete intended export-sink specification; set exactly one of s3, gcs, or azure_blob. |
| `sink_name` | string | Yes | Immutable name of the existing export sink; this is also sent as spec.name. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID containing the export sink. |
| `resource_version` | string | Yes | Current sink resourceVersion from GET_EXPORT_SINK; stale versions are rejected. |
| `async_operation_id` | string | No | Optional caller-chosen idempotency ID. Reuse it only when retrying this exact update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Namespace

**Slug:** `TEMPORAL_UPDATE_NAMESPACE`

Update a Temporal Cloud Namespace specification asynchronously using the latest resource version for optimistic concurrency. WARNING: this full-spec replacement can change retention, regions, capacity, authentication, deletion protection, and high-availability behavior; newly added custom Search Attributes cannot be deleted. Preserve every unchanged field and verify API-key access and deletion protection before calling. Requires Namespace Admin access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `spec` | object | Yes | Complete current Namespace spec with intended changes. Retain unchanged fields from DESCRIBE_NAMESPACE. |
| `namespace_id` | string | Yes | Full Cloud Namespace ID from DESCRIBE_NAMESPACE, including its account suffix. |
| `resource_version` | string | Yes | Current resourceVersion from DESCRIBE_NAMESPACE; stale versions are rejected. |
| `async_operation_id` | string | No | Optional caller-chosen idempotency ID. Reuse it only when retrying the same intended update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Namespace Tags

**Slug:** `TEMPORAL_UPDATE_NAMESPACE_TAGS`

Upsert 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 the same key cannot appear in both. The API-key owner must be a Global Admin or Account Owner; Namespace Admin access alone is insufficient.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including its account suffix. |
| `tags_to_remove` | array | No | Persistent tag keys to remove; removed tags no longer exist on the Namespace, and nonexistent keys are silently ignored. At least one of tags_to_upsert or tags_to_remove must be non-empty, and a key cannot appear in both. Requires Global Admin or Account Owner. |
| `tags_to_upsert` | object | No | Tag keys and values to add or replace. At least one of tags_to_upsert or tags_to_remove must be non-empty, and a key cannot appear in both. Requires Global Admin or Account Owner. |
| `async_operation_id` | string | No | Optional caller-chosen idempotency ID. Reuse it only when retrying the same tag update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Schedule

**Slug:** `TEMPORAL_UPDATE_SCHEDULE`

Fully 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 configuration. The replacement can change when application Workflows run and may cause irreversible external side effects. Supply conflict_token to reject a stale update. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `memo` | object | No | Unindexed Schedule Memo values encoded as Temporal json/plain Payloads. |
| `state` | object | No | Paused state, notes, and optional action limit for the Schedule. |
| `jitter` | string | No | Maximum random positive delay applied to each matching schedule time. |
| `end_time` | string | No | Inclusive RFC 3339 time after which no scheduled action may start. |
| `identity` | string | No | Caller identity recorded in Schedule history. |
| `policies` | object | No | Overlap, catchup, failure, and Workflow ID policies for the Schedule. |
| `priority` | object | No | Advanced Temporal Priority protobuf JSON for each started Workflow. |
| `arguments` | array | No | Workflow arguments encoded as json/plain Payloads; mutually exclusive with raw_payloads. |
| `calendars` | array | No | Labeled calendar expressions; Temporal compiles these into structured calendars. |
| `intervals` | array | No | Fixed interval specifications combined with any other supplied timing sources. |
| `request_id` | string | No | Idempotency ID; reuse it only when retrying the same intended mutation. |
| `start_time` | string | No | Inclusive RFC 3339 time before which no scheduled action may start. |
| `task_queue` | string | Yes | Task Queue polled by a Worker that supports workflow_type. |
| `schedule_id` | string | Yes | Application-defined Schedule ID unique within the Namespace. |
| `workflow_id` | string | No | Optional Workflow ID used by each scheduled start. Omit it to let Temporal generate a unique Workflow ID. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix, for example 'payments.a1b2c'. |
| `raw_payloads` | array | No | Exact protobuf-JSON Payloads for custom codecs; mutually exclusive with arguments. |
| `retry_policy` | object | No | Server-side retry policy applied to each scheduled Workflow. |
| `timezone_data` | string | No | Optional base64 TZif timezone definition used instead of server timezone data. |
| `timezone_name` | string | No | IANA timezone used to interpret cron expressions, such as 'America/Chicago'. |
| `user_metadata` | object | No | Advanced Temporal UserMetadata protobuf JSON for each started Workflow. |
| `workflow_memo` | object | No | Unindexed Memo values attached to each Workflow started by the Schedule. |
| `workflow_type` | string | Yes | Registered Workflow type name implemented by a compatible Worker. |
| `conflict_token` | string | No | Optional base64 conflict token from Temporal's schedule description or create response. When supplied, Temporal rejects the update if the schedule changed after that token was issued. |
| `cron_expressions` | array | No | Temporal cron expressions combined with any other supplied timing sources. |
| `workflow_headers` | object | No | Workflow header fields encoded as Temporal json/plain Payloads. |
| `exclude_calendars` | array | No | Deprecated labeled calendar expressions whose matching times are excluded. |
| `search_attributes` | object | No | Registered Schedule Search Attribute values encoded as indexed Payloads. |
| `versioning_override` | object | No | Advanced Temporal VersioningOverride protobuf JSON for each started Workflow. |
| `structured_calendars` | array | No | Programmatic calendar ranges whose matches are included in the Schedule. |
| `workflow_run_timeout` | string | No | Maximum time for one Workflow run as a positive protobuf duration. |
| `workflow_task_timeout` | string | No | Maximum time for one Workflow Task as a positive protobuf duration. |
| `workflow_execution_timeout` | string | No | Maximum total Workflow execution time as a positive protobuf duration. |
| `workflow_search_attributes` | object | No | Registered Search Attribute values attached to each started Workflow. |
| `exclude_structured_calendars` | array | No | Programmatic calendar ranges whose matching times are excluded. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Workflow

**Slug:** `TEMPORAL_UPDATE_WORKFLOW`

Send 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 update_id only when retrying the same intended Update. An admitted or accepted response can omit outcome; the returned update_ref identifies the still-running Update. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | No | Specific Workflow run ID. Omit it to update the current run. |
| `identity` | string | No | Caller identity recorded with the Workflow Update request. |
| `arguments` | array | No | Update arguments as ordinary JSON values. Each value is encoded as a Temporal json/plain Payload. Mutually exclusive with raw_payloads. |
| `update_id` | string | Yes | Workflow-scoped stable ID used to deduplicate this Update and refer to it later. Reuse it only for retries of the same intended Update. |
| `wait_stage` | string ("UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_UNSPECIFIED" | "UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_ADMITTED" | "UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_ACCEPTED" | "UPDATE_WORKFLOW_EXECUTION_LIFECYCLE_STAGE_COMPLETED") | No | Lifecycle stage the Update should reach before this call returns. A server timeout may return an earlier actual stage. |
| `update_name` | string | Yes | Workflow-author-defined name of the registered Update handler. |
| `workflow_id` | string | Yes | Application-defined Workflow ID whose Update handler will run. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host. |
| `raw_payloads` | array | No | Exact protobuf-JSON Payloads for a custom codec or non-JSON data. metadata and data byte values must be base64. Mutually exclusive with arguments. |
| `first_execution_run_id` | string | No | Chain guard requiring the current Workflow Execution to belong to the chain that began with this first run ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Workflow Options

**Slug:** `TEMPORAL_UPDATE_WORKFLOW_OPTIONS`

Update 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 behavior and thereby cause application side effects. Use only on an intended execution, capture the prior options, and restore them when testing. Requires Namespace Write access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | No | Specific run ID; omit to target the current run. |
| `options` | object | Yes | Exact WorkflowExecutionOptions values to set. Snake_case keys are canonical; protobuf lowerCamelCase aliases are also accepted. Use an explicit null to clear an option. |
| `workflow_id` | string | Yes | Application-defined Workflow ID whose execution options will change. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID including its account suffix. This validated value deterministically selects its web.tmprl.cloud host. |
| `update_fields` | array | No | Top-level protobuf FieldMask paths. Use versioning_override, priority, or time_skipping_config. If omitted, the mask is deterministically derived only from explicitly supplied options. If supplied, it must exactly match those options. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate Export Sink

**Slug:** `TEMPORAL_VALIDATE_EXPORT_SINK`

Validate 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 owner-approved disposable bucket or container.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `spec` | object | Yes | Export sink configuration to validate. Temporal writes an empty test object to the selected external bucket or container. |
| `namespace_id` | string | Yes | Full Temporal Cloud Namespace ID, including the account suffix. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |