Access Management: Role Operations

Write a role.

Create new if no id; modify existing with a given id.

Requires permission matching: role:write:<name>.

post/access/roles

Request

Request body

idstring

An opaque ID, created by Decodable, that uniquely identifies a resource.

namestring required

The role name.

descriptionstring

The role description.

Example request

{
  "id": "abcd1234"
}

Response

A role post response.

idstring

An opaque ID, created by Decodable, that uniquely identifies a resource.

namestring required

The role name.

descriptionstring

The role description.

create_timestring date-time

The date and time the resource was created.

update_timestring date-time

The date and time the resource was updated.

Example response

{
  "id": "abcd1234"
}

Changes

No recorded changes to this operation across all 1 revision of this API.