• Array of: object RoleDtoParamsV3
  Represents an application role and its assignment attributes, including identifiers and display information.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/RoleDtoParamsV3"
    }
}

• authorizedUserId: string (uuid)
• comment: string
• effectiveEnd: string (date-time)
• effectiveStart: string (date-time)
• id(required): string (uuid)
  Unique identifier of the application role.
• modeId: string (uuid)
• objectVersionNumber: number
• operationType: string
• reason: string
• rightId: string (uuid)
• roleCategory(required): string
  Business category of the role.

  Example: Study
• roleName(required): string
  Human-readable role name.

  Example: VIEWER
• roleSeq: number (int32)
  Role sequence/order in assignment.

  Example: 1
• roleSubCategory: string
• roleType(required): string
  Type of the role (e.g., Application, Study, Global).

  Example: Application
• softwareVersionNumber: number
• StudyID: string (uuid)
• StudyRoleID: string (uuid)
• unblinded: string
  Indicates if the role is unblinded (Y/N).

  Example: Y
• userId: string (uuid)
• versionEnd: string (date-time)
• versionStart: string (date-time)

{
    "required":[
        "id",
        "roleCategory",
        "roleName",
        "roleType"
    ],
    "type":"object",
    "properties":{
        "StudyID":{
            "type":"string",
            "format":"uuid"
        },
        "authorizedUserId":{
            "type":"string",
            "format":"uuid"
        },
        "modeId":{
            "type":"string",
            "format":"uuid"
        },
        "StudyRoleID":{
            "type":"string",
            "format":"uuid"
        },
        "id":{
            "type":"string",
            "description":"Unique identifier of the application role.",
            "format":"uuid"
        },
        "rightId":{
            "type":"string",
            "format":"uuid"
        },
        "roleName":{
            "type":"string",
            "description":"Human-readable role name.",
            "example":"VIEWER"
        },
        "roleType":{
            "type":"string",
            "description":"Type of the role (e.g., Application, Study, Global).",
            "example":"Application"
        },
        "roleCategory":{
            "type":"string",
            "description":"Business category of the role.",
            "example":"Study"
        },
        "roleSubCategory":{
            "type":"string"
        },
        "unblinded":{
            "type":"string",
            "description":"Indicates if the role is unblinded (Y/N).",
            "example":"Y"
        },
        "roleSeq":{
            "type":"number",
            "description":"Role sequence/order in assignment.",
            "format":"int32",
            "example":1
        },
        "effectiveStart":{
            "type":"string",
            "format":"date-time"
        },
        "effectiveEnd":{
            "type":"string",
            "format":"date-time"
        },
        "versionStart":{
            "type":"string",
            "format":"date-time"
        },
        "versionEnd":{
            "type":"string",
            "format":"date-time"
        },
        "operationType":{
            "type":"string"
        },
        "userId":{
            "type":"string",
            "format":"uuid"
        },
        "objectVersionNumber":{
            "type":"number"
        },
        "softwareVersionNumber":{
            "type":"number"
        },
        "reason":{
            "type":"string"
        },
        "comment":{
            "type":"string"
        }
    },
    "description":"Represents an application role and its assignment attributes, including identifiers and display information.",
    "example":{
        "id":"37EFDC494C944E58ADAC8DA952A2C60C",
        "roleName":"Site User",
        "roleType":"Application",
        "roleCategory":"Study",
        "roleSeq":1,
        "unblinded":"Y"
    }
}

{
    "id":"37EFDC494C944E58ADAC8DA952A2C60C",
    "roleName":"Site User",
    "roleType":"Application",
    "roleCategory":"Study",
    "roleSeq":1,
    "unblinded":"Y"
}

• errorData: object ErrorResponseData
  Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
• result: object result
  Result data of the API response; actual type depends on the API
• status: string (none)
  Indicates request success ("success") or failure ("failure").

  Example: success
• version: integer (int32)
  Version of the response schema.

  Example: 1

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Indicates request success (\"success\") or failure (\"failure\").",
            "format":"none",
            "example":"success"
        },
        "result":{
            "type":"object",
            "description":"Result data of the API response; actual type depends on the API",
            "example":null
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        },
        "version":{
            "type":"integer",
            "description":"Version of the response schema.",
            "format":"int32",
            "example":1
        }
    },
    "description":"Generic API response wrapper containing result, error data, response version and status."
}

• details: string
  Detailed error context or debugging information such as validation error, stack trace, or field/parameter cause.

  Example: User role is missing required permission REPORTING_VIEW. Field: userId
• errorCode: string
  Application or business-specific error code representing the error type.

  Example: REPT_401
• errorMessage: string
  Human-readable error message describing the failure or issue.

  Example: Unauthorized: User does not have access to the requested resource

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Application or business-specific error code representing the error type.",
            "example":"REPT_401"
        },
        "errorMessage":{
            "type":"string",
            "description":"Human-readable error message describing the failure or issue.",
            "example":"Unauthorized: User does not have access to the requested resource"
        },
        "details":{
            "type":"string",
            "description":"Detailed error context or debugging information such as validation error, stack trace, or field/parameter cause.",
            "example":"User role is missing required permission REPORTING_VIEW. Field: userId"
        }
    },
    "description":"Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details."
}