1. REST API for Clinical One Platform
  2. Tasks
  3. Users, Permissions and Roles
  4. Roles
  5. v1.0

[Deprecated]: Get a user's modes and roles
get

/ec-auth-svc/rest/v1.0/authusers/{userid}/studies/{StudyID}

Deprecated: Use /v2.0/authusers/{userid}/studies/{StudyID} for the updated API. The latest version supports richer assignment payloads, improved validation and more extensible structure. This endpoint only retrieves current assignments, while the new version supports updates with detailed structure and request validation. Deprecated: Use latest version instead. Retrieves the modes and roles for a user and a study.

Request

Path Parameters

There's no request body for this operation.

Back to Top

Response

Supported Media Types

200 Response

Success
Body ()
Root Schema : DisplayUserStudyModeRoleListDto
Type: object
Represents a user's assigned modes, roles, sites, and depots within a study, with study-wide effective dates.
Show Source
Example:
{
    "effectiveStart":"2020-06-17T10:15:30.000Z",
    "effectiveEnd":"2025-06-17T10:15:30.000Z",
    "modes":[
        {
            "modeName":"active",
            "roles":[
                {
                    "id":"F7A0E5390A1F43A9AF5346EB88AC921A",
                    "roleName":"Rule Designer"
                },
                {
                    "id":"EA0D45A19A6E45CDAAD5F2DB7BD4E104",
                    "roleName":"Site User"
                }
            ],
            "sites":{
                "allSites":false,
                "associatedSites":[
                    {
                        "id":"946E7D36031941CCA39CD2B2CFF2899B",
                        "siteName":"SiteA"
                    },
                    {
                        "id":"FE8925CFA8A74193A2E8D8326E7FEA88",
                        "siteName":"SiteB"
                    }
                ]
            },
            "depots":{
                "allDepots":false,
                "associatedDepots":[
                    {
                        "id":"CEE624A4E7EB43059C6AEC24673A288B",
                        "depotName":"DepotA"
                    }
                ]
            }
        }
    ]
}
Nested Schema : modes
Type: object
Represents a user's mode assignment in a study, including mode name, assigned roles, sites, and depots.
Show Source
Example:
{
    "modeName":"active",
    "roles":[
        {
            "id":"F7A0E5390A1F43A9AF5346EB88AC921A",
            "roleName":"Rule Designer"
        },
        {
            "id":"EA0D45A19A6E45CDAAD5F2DB7BD4E104",
            "roleName":"Site User"
        }
    ],
    "sites":{
        "allSites":false,
        "associatedSites":[
            {
                "id":"946E7D36031941CCA39CD2B2CFF2899B",
                "siteName":"SiteA"
            },
            {
                "id":"FE8925CFA8A74193A2E8D8326E7FEA88",
                "siteName":"SiteB"
            }
        ]
    },
    "depots":{
        "allDepots":false,
        "associatedDepots":[
            {
                "id":"CEE624A4E7EB43059C6AEC24673A288B",
                "depotName":"DepotA"
            }
        ]
    }
}
Nested Schema : DisplayDepotsListDto
Type: object
List of depots assigned to a user.
Show Source
Example:
{
    "allDepots":false,
    "associatedDepots":[
        {
            "id":"CEE624A4E7EB43059C6AEC24673A288B",
            "depotName":"DepotA"
        }
    ]
}
Nested Schema : roles
Type: object
Associates a user with a global role.
Show Source
Example:
{
    "id":"A519EF3C2B73455390CFF812AFF61519",
    "roleName":"STUDY_MANAGER"
}
Nested Schema : DisplaySitesListDto
Type: object
List of sites assigned to a user.
Show Source
Example:
{
    "allSites":false,
    "associatedSites":[
        {
            "id":"946E7D36031941CCA39CD2B2CFF2899B",
            "siteName":"SiteA"
        },
        {
            "id":"FE8925CFA8A74193A2E8D8326E7FEA88",
            "siteName":"SiteB"
        }
    ]
}
Nested Schema : associatedDepots
Type: object
Represents a clinical depot.
Show Source
Example:
{
    "id":"CEE624A4E7EB43059C6AEC24673A288B",
    "depotName":"DepotA"
}
Nested Schema : associatedSites
Type: object
Represents a clinical trial site.
Show Source
Example:
{
    "id":"946E7D36031941CCA39CD2B2CFF2899B",
    "siteName":"SiteA"
}
Examples

400 Response

Bad request
Body ()
Root Schema : AuthResponse
Type: object
Generic API response wrapper containing result, error data, response version and status.
Show Source
Nested Schema : ErrorResponseData
Type: object
Structure representing an error response from the reporting service. Contains an error code, human-readable message, and details.
Show Source
  • 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
  • Application or business-specific error code representing the error type.
    Example: REPT_401
  • Human-readable error message describing the failure or issue.
    Example: Unauthorized: User does not have access to the requested resource
Nested Schema : result
Type: object
Result data of the API response; actual type depends on the API
Example:
oracle.doceng.json.BetterJsonNull@3565a0f5
Back to Top