openproject/docs/api/apiv3/components/schemas/role_model.yml

# Schema: RoleModel
---
type: object
required:
- name
properties:
  id:
    type: integer
    description: Role id
    readOnly: true
    minimum: 0
    exclusiveMinimum: true
  name:
    type: string
    description: Role name
  _links:
    type: object
    required:
    - self
    properties:
      self:
        allOf:
        - "$ref": "./link.yml"
        - description: |-
            This role

            **Resource**: Role
          readOnly: true
example:
  _type: Role
  id: 3
  name: Manager
  _links:
    self:
      href: "/api/v3/roles/3"
      title: Manager