Jump to

• Request
• Response

Creates a new user role

post

/learn.rest/v1/learnCenters/{learnCenterId}/userRoles

Request

Supported Media Types

• application/json

Path Parameters

• learnCenterId: number
  Unique identifier of a LearnCenter.

Body ()

User role object that needs to be created.

Root Schema : UserRoleRequest

Type: object

Object containing the user role parameters.

Show Source

• description(optional): string
  Description of the user role.

  Example: test
• name: string
  Name of the user role.

  Example: admin role
• permissions(optional): array permissions
  Permissions granted for the user role.
• statusFlag(optional): boolean
  Default Value: true

  Status of the user role.

  Example: true

{
    "type":"object",
    "description":"Object containing the user role parameters.",
    "required":[
        "name"
    ],
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the user role.",
            "example":"admin role"
        },
        "description":{
            "type":"string",
            "example":"test",
            "description":"Description of the user role."
        },
        "permissions":{
            "type":"array",
            "description":"Permissions granted for the user role.",
            "items":{
                "properties":{
                    "id":{
                        "type":"string",
                        "description":"User role id."
                    }
                }
            },
            "example":[
                "receiveComSystemMessages",
                "attachFilesToMessages",
                "emailCompletionCertificates",
                "useForums",
                "viewReviews",
                "addGlobalLCCalendarEvents",
                "insertNewReviews",
                "viewLearnCenterPages",
                "viewInsightReportingReports",
                "sendComSystemMessages",
                "viewCoursePages",
                "useComSystemAddressBook",
                "useChatRooms",
                "useCommunicationTools",
                "modifyReviews",
                "printCompletionCertificates",
                "viewCertificatesContent",
                "viewContent"
            ]
        },
        "statusFlag":{
            "type":"boolean",
            "default":true,
            "example":true,
            "description":"Status of the user role."
        }
    }
}

Nested Schema : permissions

Type: array

Permissions granted for the user role.

Show Source

• Array of: object items

{
    "type":"array",
    "description":"Permissions granted for the user role.",
    "items":{
        "properties":{
            "id":{
                "type":"string",
                "description":"User role id."
            }
        }
    },
    "example":[
        "receiveComSystemMessages",
        "attachFilesToMessages",
        "emailCompletionCertificates",
        "useForums",
        "viewReviews",
        "addGlobalLCCalendarEvents",
        "insertNewReviews",
        "viewLearnCenterPages",
        "viewInsightReportingReports",
        "sendComSystemMessages",
        "viewCoursePages",
        "useComSystemAddressBook",
        "useChatRooms",
        "useCommunicationTools",
        "modifyReviews",
        "printCompletionCertificates",
        "viewCertificatesContent",
        "viewContent"
    ]
}

Example:

[
    "receiveComSystemMessages",
    "attachFilesToMessages",
    "emailCompletionCertificates",
    "useForums",
    "viewReviews",
    "addGlobalLCCalendarEvents",
    "insertNewReviews",
    "viewLearnCenterPages",
    "viewInsightReportingReports",
    "sendComSystemMessages",
    "viewCoursePages",
    "useComSystemAddressBook",
    "useChatRooms",
    "useCommunicationTools",
    "modifyReviews",
    "printCompletionCertificates",
    "viewCertificatesContent",
    "viewContent"
]

Nested Schema : items

Type: object

Show Source

• id(optional): string
  User role id.

{
    "properties":{
        "id":{
            "type":"string",
            "description":"User role id."
        }
    }
}

Security

• auth: basic
  Type: basic

  Description: Basic Authentication

Back to Top

Response

Supported Media Types

• application/json

201 Response

A new user role is created.

Body ()

Root Schema : UserRoleResponse

Type: object

Object comprising all the item parameters.

Show Source

• description(optional): string
  Description of the user role.

  Example: test
• id(optional): number
  Example: 234
• links(optional): array links
  Link to the User role items.
• name(optional): string
  Name of the user role

  Example: admin role
• permissions(optional): array permissions
  Permissions applicable to a user role.
• statusFlag(optional): boolean
  Default Value: true

  Status of the user role.

  Example: true

{
    "type":"object",
    "description":"Object comprising all the item parameters.",
    "properties":{
        "id":{
            "type":"number",
            "example":234
        },
        "name":{
            "type":"string",
            "example":"admin role",
            "description":"Name of the user role"
        },
        "description":{
            "type":"string",
            "example":"test",
            "description":"Description of the user role."
        },
        "permissions":{
            "type":"array",
            "description":"Permissions applicable to a user role.",
            "items":{
                "properties":{
                    "id":{
                        "type":"string"
                    }
                }
            },
            "example":[
                "receiveComSystemMessages",
                "attachFilesToMessages",
                "emailCompletionCertificates",
                "useForums",
                "viewReviews",
                "addGlobalLCCalendarEvents",
                "insertNewReviews",
                "viewLearnCenterPages",
                "viewInsightReportingReports",
                "sendComSystemMessages",
                "viewCoursePages",
                "useComSystemAddressBook",
                "useChatRooms",
                "useCommunicationTools",
                "modifyReviews",
                "printCompletionCertificates",
                "viewCertificatesContent",
                "viewContent"
            ]
        },
        "statusFlag":{
            "type":"boolean",
            "default":true,
            "example":true,
            "description":"Status of the user role."
        },
        "links":{
            "type":"array",
            "description":"Link to the User role items.",
            "items":{
                "$ref":"#/definitions/UserRoleLinkItem"
            }
        }
    }
}

Nested Schema : links

Type: array

Link to the User role items.

Show Source

• Array of: object UserRoleLinkItem

{
    "type":"array",
    "description":"Link to the User role items.",
    "items":{
        "$ref":"#/definitions/UserRoleLinkItem"
    }
}

Nested Schema : permissions

Type: array

Permissions applicable to a user role.

Show Source

• Array of: object items

{
    "type":"array",
    "description":"Permissions applicable to a user role.",
    "items":{
        "properties":{
            "id":{
                "type":"string"
            }
        }
    },
    "example":[
        "receiveComSystemMessages",
        "attachFilesToMessages",
        "emailCompletionCertificates",
        "useForums",
        "viewReviews",
        "addGlobalLCCalendarEvents",
        "insertNewReviews",
        "viewLearnCenterPages",
        "viewInsightReportingReports",
        "sendComSystemMessages",
        "viewCoursePages",
        "useComSystemAddressBook",
        "useChatRooms",
        "useCommunicationTools",
        "modifyReviews",
        "printCompletionCertificates",
        "viewCertificatesContent",
        "viewContent"
    ]
}

Example:

[
    "receiveComSystemMessages",
    "attachFilesToMessages",
    "emailCompletionCertificates",
    "useForums",
    "viewReviews",
    "addGlobalLCCalendarEvents",
    "insertNewReviews",
    "viewLearnCenterPages",
    "viewInsightReportingReports",
    "sendComSystemMessages",
    "viewCoursePages",
    "useComSystemAddressBook",
    "useChatRooms",
    "useCommunicationTools",
    "modifyReviews",
    "printCompletionCertificates",
    "viewCertificatesContent",
    "viewContent"
]

Nested Schema : UserRoleLinkItem

Type: object

Show Source

• href(optional): string
• rel(optional): string

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    },
    "example":{
        "rel":"canonical",
        "href":"https://{url}/learn.rest/v1/learnCenters/178409/userRoles/639"
    }
}

Example:

{
    "rel":"canonical",
    "href":"https://{url}/learn.rest/v1/learnCenters/178409/userRoles/639"
}

Nested Schema : items

Type: object

Show Source

• id(optional): string

{
    "properties":{
        "id":{
            "type":"string"
        }
    }
}

400 Response

Request has incorrect syntax or does not contain a field that is required.

401 Response

Authentication refused for provided credentials or the token is invalid.

Headers

• WWW_Authenticate: string

404 Response

Resource not found.

422 Response

Request may contain validation errors.

500 Response

Internal server error.

Back to Top