roles

Archives or unarchives the role.

Changed on

Archives or unarchives the role. An archived role still exists for all users currently using it, but users can no longer be assigned to this role.

<Check title="Required Permissions" icon="key">The user must be an admin or have task-manage-config:write permissions.</Check>

post/roles/{roleId}/setarchived

Request

  • Base URL: https://api.awork.com/api/v1
  • URL: https://api.awork.com/api/v1/roles/{roleId}/setarchived
  • Auth: HTTP bearer

Path parameters

roleIdstring uuid required

The id of the role.

Request body

isArchivedboolean

Flags the entity as archived.

Response

OK

namestring required

The name of the role. Must be unique.

isAdminRoleboolean

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

isGuestRoleboolean

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

idstring uuid

The id of the role.

isAgentRoleboolean

Whether this is a retained role from the legacy agent-as-user model. The role cannot be modified.

isPresetboolean

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

isArchivedboolean

Whether the role has been archived.

createdBystring uuid

The id of the user who created this role.

createdOnstring date-time

The date this role was created.

updatedBystring uuid

The id of the user who updated this role.

updatedOnstring date-time

The date this role was last modified.

Changes

  • 1556e0487867Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API

  • 8e46cf415581Revision changes
    • info

      api operation id PostRoleSetArchivedByRoleId removed and replaced with roles_PostRoleSetArchivedByRoleId