required:
  - grant
type: object
properties:
  grant:
    required:
      - role
    type: object
    properties:
      role:
        type: string
        description: |
          The friendly ID of the role. Valid values are dependent on the entity type
          e.g. when the entity type is `mock-api` the valid roles are the ones prefixed with `mock_api_`
        enum:
          - mock_api_user
          - mock_api_editor
          - mock_api_admin
          - team_member
          - team_admin
          - organisation_member
          - organisation_admin
        example: mock_api_editor