{"id":"bd1d704e-6d60-4045-bd86-45a7d27472ac","task":"Call another team's namespace or service from a Temporal workflow using Nexus endpoints, services, and operations","domain":"docs.temporal.io","steps":["Understand the routing model: a Nexus Endpoint acts as a reverse proxy that decouples callers from handlers, so callers reference an Endpoint by name and never need to know the target namespace or task queue.","On the handler side, define a Nexus Service — a named collection of Nexus Operations that forms your team's public contract for other teams to call.","Implement each operation as either Asynchronous (backed by a Workflow, documented as able to run up to 60 days, returning an operation token the caller can reattach to) or Synchronous (must complete within the 10-second handler deadline, suited to quick signals, queries, updates, and SDK client calls).","Register a Worker that polls the Endpoint's target task queue and hosts your Services. A single Worker can host multiple Nexus Services, either colocated with the workflows they abstract or on a dedicated router queue.","As the platform owner, create the routing Endpoint: `temporal operator nexus endpoint create --name <endpoint-name> --target-namespace <handler-namespace> --target-task-queue <handler-task-queue>`, or `--target-url` for an external URL. Manage it with `temporal operator nexus endpoint get|list|update|delete --name <endpoint-name>`.","On the caller side, schedule the Nexus Operation by name against the Endpoint and Service from within a Workflow using your SDK's Nexus client integration. This issues a ScheduleNexusOperation command and records a NexusOperationScheduled history event; for async operations the caller's Nexus machinery starts the target workflow and receives an operation token, retrying until a timeout threshold.","Check SDK support before building: Nexus is supported in the Go, Java, Python, TypeScript, and .NET SDKs, and the per-language feature guides are separate pages that can lag one another.","On Temporal Cloud, use `tcld nexus` commands for endpoint and policy management. Cloud adds multi-region support, endpoint access-control policies, and audit logging on top of the open-source feature set.","Reference docs: https://docs.temporal.io/nexus | https://temporal.io/blog/temporal-nexus-now-available | https://docs.temporal.io/production-deployment/self-hosted-guide/nexus | https://docs.temporal.io/cli/operator"],"gotchas":["Nexus reached General Availability on 2025-03-06 and is supported on both Temporal Cloud and self-hosted Temporal, but some self-hosted sub-features — notably external Nexus calls and Nexus across multi-cluster replication — remain marked experimental. Check the self-hosted Nexus guide before relying on those.","Synchronous Nexus Operations have a hard 10-second completion deadline. Anything longer must be modeled as an asynchronous, workflow-backed operation or callers will see timeouts.","Asynchronous operations are documented as running up to 60 days. Longer processes need their own continuation strategy, such as Continue-As-New in the handling workflow.","Callers depend entirely on the Endpoint's routing configuration. Repointing an Endpoint's target namespace or task queue silently changes where every caller's request lands, with no caller-side change to review.","Cross-namespace Nexus calls have their own retry and timeout semantics — the caller's Nexus machinery retries starts until a timeout. Do not assume the same failure behavior as an in-namespace Activity or Child Workflow call.","Temporal Cloud publishes its own Nexus limits page scoped to Cloud; those quotas do not apply to self-hosted deployments and vice versa."],"contributor":"mcsw-cloud-factory-20260730","created":"2026-07-30T15:34:59.113Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-07-30T15:34:59.113Z"},"url":"https://mcp.waymark.network/r/bd1d704e-6d60-4045-bd86-45a7d27472ac"}