Jump to

• Request
• Response

Updates subset of properties for a group

patch

/learn.rest/v1/learnCenters/{learnCenterId}/groups/{groupId}

Request

Supported Media Types

• application/json

Path Parameters

• groupId: number
  Unique identifier of a group.
• learnCenterId: number
  Unique identifier of LearnCenter.

Body ()

Group object that needs to be created.

Root Schema : GroupRequest

Type: object

Show Source

• activeFromDate(optional): string(date-time)
• activeUntilDate(optional): string(date-time)
• code(optional): string
• groupname: string
  Maximum Length: 50

  name of the group
• onlyAllowOwnersToEditGroup(optional): boolean
  Default Value: true
• owners(optional): array owners
• parentgroupid(optional): number
  id of the parent group
• selfServiceOptions(optional):
  Allowed Values: [ "private", "requiresApproval", "doesNotRequireApprovals" ]
• statusFlag(optional): string
  Allowed Values: [ "inactive", "active" ]

  status of group

{
    "type":"object",
    "required":[
        "groupname"
    ],
    "properties":{
        "groupname":{
            "maxLength":50,
            "type":"string",
            "description":"name of the group"
        },
        "parentgroupid":{
            "type":"number",
            "description":"id of the parent group"
        },
        "statusFlag":{
            "type":"string",
            "description":"status of group",
            "enum":[
                "inactive",
                "active"
            ]
        },
        "code":{
            "type":"string"
        },
        "activeFromDate":{
            "format":"date-time",
            "type":"string"
        },
        "activeUntilDate":{
            "format":"date-time",
            "type":"string"
        },
        "onlyAllowOwnersToEditGroup":{
            "default":true,
            "type":"boolean"
        },
        "selfServiceOptions":{
            "enum":[
                "private",
                "requiresApproval",
                "doesNotRequireApprovals"
            ]
        },
        "owners":{
            "type":"array",
            "items":{
                "properties":{
                    "id":{
                        "type":"number"
                    }
                }
            }
        }
    },
    "example":{
        "name":"ck test group test 123",
        "parentGroupId":766,
        "statusFlag":"active",
        "code":"481werfa-dc63-4d92-8a08-12f807eab82d",
        "activeFromDate":"2017-05-06T00:00:00",
        "activeUntilDate":"2017-06-06T00:00:00",
        "createdDate":"2013-06-17T18:27:01.843",
        "createdByUserId":113458,
        "lastUpdatedDate":"2018-03-20T05:00:01.553",
        "lastUpdatedByUserId":1000,
        "onlyAllowOwnersToEditGroup":false,
        "selfServiceOptions":"doesNotRequireApprovals",
        "owners":[
            113458,
            112898
        ]
    }
}

Example:

{
    "name":"ck test group test 123",
    "parentGroupId":766,
    "statusFlag":"active",
    "code":"481werfa-dc63-4d92-8a08-12f807eab82d",
    "activeFromDate":"2017-05-06T00:00:00",
    "activeUntilDate":"2017-06-06T00:00:00",
    "createdDate":"2013-06-17T18:27:01.843",
    "createdByUserId":113458,
    "lastUpdatedDate":"2018-03-20T05:00:01.553",
    "lastUpdatedByUserId":1000,
    "onlyAllowOwnersToEditGroup":false,
    "selfServiceOptions":"doesNotRequireApprovals",
    "owners":[
        113458,
        112898
    ]
}

Nested Schema : owners

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "properties":{
            "id":{
                "type":"number"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

• id(optional): number

{
    "properties":{
        "id":{
            "type":"number"
        }
    }
}

Security

• auth: basic
  Type: basic

  Description: Basic Authentication

Back to Top

Response

Supported Media Types

• application/json

200 Response

Resource updated.

400 Response

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

401 Response

Authentication refused for provided credentials or token 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