Inconsistency in creating and updating a custom organization role

[munlicode]

// CreateOrUpdateOrgRoleOptions represents options required to create or update a custom organization role.
type CreateOrUpdateOrgRoleOptions struct {
	Name        *string  `json:"name,omitempty"`
	Description *string  `json:"description,omitempty"`
	Permissions []string `json:"permissions"`
	BaseRole    *string  `json:"base_role,omitempty"`
}

It seems like it does not follow documentation, because CreateCustomOrgRole should expect at least name and permissions, and UpdateCustomOrgRole does not demand any of those to be present.

Is it intentional?

Documentation references:

• https://docs.github.com/en/enterprise-cloud@latest/rest/orgs/organization-roles?apiVersion=2022-11-28#create-a-custom-organization-role
• https://docs.github.com/enterprise-cloud@latest/rest/orgs/organization-roles#update-a-custom-organization-role

[gmlewis]

In general, mismatches with the official GitHub v3 API docs are not intentional unless a comment explicitly says otherwise.

Any inconsistencies found you are welcome to fix.

Thank you, @munlicode!