Skip to content

Clarify that full Namespace ID (name.accountid) is required for all operations#4473

Open
LutaoX wants to merge 3 commits intotemporalio:mainfrom
LutaoX:clarify-namespace-id-usage
Open

Clarify that full Namespace ID (name.accountid) is required for all operations#4473
LutaoX wants to merge 3 commits intotemporalio:mainfrom
LutaoX:clarify-namespace-id-usage

Conversation

@LutaoX
Copy link
Copy Markdown
Contributor

@LutaoX LutaoX commented Apr 22, 2026

Summary

  • Adds a note callout immediately after the Namespace Name naming rules making the schema explicit: the full Namespace ID (<namespace-name>.<account-id>) is required for all SDK connections, CLI commands, and API calls — the short name alone is not sufficient
  • Reframes the Account ID section from "you may need to discover your Account ID" to "the Account ID is part of every Namespace ID", which matches how users actually encounter it
  • Links the note to the existing Cloud Namespace ID section for full details

Motivation

The current docs treat the name.accountid format as a mechanism for discovering an Account ID, rather than as the primary identifier users must use everywhere. New users frequently attempt to connect using just the short namespace name and get confusing errors.

Test plan

  • Verify note renders correctly in the docs site
  • Check anchor link #temporal-cloud-namespace-id resolves correctly

🤖 Generated with Claude Code

┆Attachments: EDU-6251 Clarify that full Namespace ID (name.accountid) is required for all operations

LutaoX and others added 3 commits February 24, 2026 18:36
…main?

Clarifies that multiple Cloud accounts can share an email domain, each
with independent SAML configuration. Recommends IdP-initiated login for
smoother multi-account access.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…perations

Add a note callout after the Namespace Name naming rules that makes the
schema explicit: users must use <namespace-name>.<account-id> in all
SDK connections, CLI commands, and API calls. The short name alone is
not sufficient.

Also reframe the Account ID section away from "you may need to discover
your Account ID" toward "the Account ID is part of every Namespace ID."

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@LutaoX LutaoX requested a review from a team as a code owner April 22, 2026 20:16
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 22, 2026

@LutaoX is attempting to deploy a commit to the Temporal Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant