chore: rename authorization to role assignment (#11588)

# Which Problems Are Solved

As part of the naming consistency initiative, the terms Authorization,
User grants, internal authorization and other similar terms that are
used in the context of assigning project roles to users are replaced by
Role Assignments in the UI, API docs, and documentation.

# How the Problems Are Solved

By replacing the following terms with Role Assignments in API docs,
Console UI, and guides.

- Authorization
- internal authorization
- external authorization
- User Grant
- Roles and Authorizations

By adding a note in the API docs to make it clear that Authorization
within the context of Authorization Service API refers to role
assignments, not to OAuth authorization as it is still used in the APIs.

By updating some screenshots in documentation / guides to show "Role
Assignments" instead of "Authorizations" in the UI.

# Additional Changes

N/A

# Additional Context

- Closes https://github.com/zitadel/zitadel/issues/11289

---------

Co-authored-by: Copilot <[email protected]>
This commit is contained in:
Gayathri Vijayan
2026-02-17 13:14:57 +01:00
committed by GitHub
co-authored by Copilot
parent fa5e76661a
commit 93a4ed8857
76 changed files with 1066 additions and 1015 deletions
+7 -5
View File
@@ -43,12 +43,14 @@ title: Objects
## user grant
A user grant is a role assignment for a user.
- `projectID` *string*
Required. ID of the project to be granted
Required. ID of the project for the role assignment.
- `projectGrantID` *string*
Optional. If the grant is for a project grant, include projectGrantID
Optional. If the role assignment is for a project grant, include projectGrantID
- `roles` Array of *string*
Containing the roles
Roles to assign to the user.
## user
@@ -182,11 +184,11 @@ This object represents [the claims](../openidoauth/claims) which will be written
- `email_verified` *bool*
- `updated_at` *Number*
Additionally, there could be fields depending on the configuration of your [project](../../guides/manage/console/projects-overview#role-settings) and your [application](../../guides/manage/console/applications-overview#token-settings)
There could be additional fields depending on the configuration of your [project](../../guides/manage/console/projects-overview#role-settings) and your [application](../../guides/manage/console/applications-overview#token-settings)
## user grant list
This object represents a list of user grant stored in ZITADEL.
This object represents a list of user grants (role assignments) stored in ZITADEL.
- `count` *Number*
- `sequence` *Number*