Skip to content

Clarify GetUser response fields by account role - #5232

Merged
lennessyy merged 5 commits into
temporalio:mainfrom
LutaoX:docs/user-get-authorization-behavior
Sep 4, 2026
Merged

Clarify GetUser response fields by account role#5232
lennessyy merged 5 commits into
temporalio:mainfrom
LutaoX:docs/user-get-authorization-behavior

Conversation

@LutaoX

@LutaoX LutaoX commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Document that GetUser and GetUsers succeed for every account-level role, but another user's access and invitation are returned only to Account Owner and Global Admin.
  • Add GetUserNamespaceAssignments to the Namespace Cloud Ops matrix (Namespace Admin only). That is the API for listing who has access to a Namespace.

Why

The permissions matrix previously implied that every role can inspect another user's account role and Namespace permissions. Non-admin callers get HTTP 200 with those fields omitted. Customers (including codec-server least-privilege setups) were hitting this gap.

Test plan

  • Confirm the footnote on GetUser and GetUsers links to User authorization behavior
  • Confirm GetUserNamespaceAssignments appears only under Namespace Admin
  • Preview the permissions reference page and check heading anchors

Made with Cursor

Co-authored-by: Cursor <cursoragent@cursor.com>
Copilot AI balanced review requested due to automatic review settings September 2, 2026 15:25
@LutaoX
LutaoX requested a review from a team as a code owner September 2, 2026 15:25
@vercel

vercel Bot commented Sep 2, 2026

Copy link
Copy Markdown

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

A member of the Team first needs to authorize it.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The duplicate user permissions matrix remains misleading without the new response-scope caveat.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Clarifies role-dependent user API responses and Namespace assignment permissions.

Changes:

  • Adds authorization caveats for GetUser and GetUsers.
  • Adds GetUserNamespaceAssignments to the Namespace Admin matrix.
  • Links the operation in the Custom Role table.
File summaries
File Description
docs/cloud/manage-access/permissions-reference.mdx Updates permission matrices and authorization guidance.
docs/cloud/manage-access/_custom_role_permissions_table.mdx Links the Namespace assignment operation.
Review details
  • Files reviewed: 2/2 changed files
  • Comments generated: 1
  • Review effort level: Balanced

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/cloud/manage-access/permissions-reference.mdx
@vercel

vercel Bot commented Sep 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
temporal-documentation Ready Ready Preview Sep 4, 2026 6:23pm UTC

Request Review

@lennessyy
lennessyy enabled auto-merge (squash) September 4, 2026 18:27
@lennessyy
lennessyy disabled auto-merge September 4, 2026 18:27
@lennessyy
lennessyy merged commit 7df6f1d into temporalio:main Sep 4, 2026
12 of 14 checks passed
@LutaoX
LutaoX deleted the docs/user-get-authorization-behavior branch September 4, 2026 18:44
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.

3 participants