API v1 ReferenceRoles

Updates the role with the specified id.

Updates the role with the specified id.

Required Permissions
The user must be an admin or have workspace-manage-config:write permissions.

Path parameters

roleIdUUIDRequired

The id of the role.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringRequired>=1 character

The name of the role. Must be unique.

isAdminRolebooleanOptional

Whether this is the admin role. Only one role can be the admin role.

isGuestRolebooleanOptional

Whether this is the guest role. Only one role can be the guest role.

Response

OK

namestring>=1 character

The name of the role. Must be unique.

isAdminRolebooleanOptional

Whether this is the admin role. Only one role can be the admin role.

isGuestRolebooleanOptional

Whether this is the guest role. Only one role can be the guest role.

idUUIDOptional

The id of the role.

isPresetbooleanOptional

Whether this role is one of the preset roles. Preset roles can be edited, archived and deleted.

isArchivedbooleanOptional

Whether the role has been archived.

createdByUUIDOptional

The id of the user who created this role.

createdOndatetimeOptional

The date this role was created.

updatedByUUIDOptional

The id of the user who updated this role.

updatedOndatetimeOptional

The date this role was last modified.