Jump to

• Request
• Response

Get group details by group id.

get

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

Request

Path Parameters

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

Back to Top

Response

Supported Media Types

• application/json

200 Response

Group fetched.

Body ()

Root Schema : GroupResponse

Type: object

Show Source

• activeFromDate(optional): string(datetime)
  Example: 2017-05-06T00:00:00
• activeUntilDate(optional): string(datetime)
  Example: 2017-06-06T00:00:00
• code(optional): string
  Example: 481bacda-dc63-4d92-8a08-12f807eab82d
• createdBy(optional): array createdBy
• createdByUserId(optional): number
  Example: 123123
• createdDate(optional): string(datetime)
  Example: 2013-06-17T18:27:01.843
• id(optional): number
  Example: 766
• lastUpdatedBy(optional): array lastUpdatedBy
• lastUpdatedByUserId(optional): number
  Example: 123123
• lastUpdatedDate(optional): string(datetime)
  Example: 2018-03-20T05:00:01.553
• links(optional): array links
• name(optional): string
  Example: my group
• onlyAllowOwnersToEditGroup(optional): boolean
  Example: true
• owners(optional): array owners
• parentGroupId(optional): number
  Example: 123
• selfServiceOptions(optional): string
  Allowed Values: [ "open", "doesNotRequireApprovals", "requiresApproval" ]

  enum for selfServiceOptions are: open, doesNotRequireApprovals, requiresApproval

  Example: open
• statusFlag(optional): string
  Allowed Values: [ "active", "inactive" ]

  enum for statusFlag are: active, inactive

  Example: active

{
    "type":"object",
    "properties":{
        "id":{
            "type":"number",
            "example":766
        },
        "name":{
            "type":"string",
            "example":"my group"
        },
        "parentGroupId":{
            "type":"number",
            "example":123
        },
        "statusFlag":{
            "type":"string",
            "description":"enum for statusFlag are: active, inactive",
            "enum":[
                "active",
                "inactive"
            ],
            "example":"active"
        },
        "code":{
            "type":"string",
            "example":"481bacda-dc63-4d92-8a08-12f807eab82d"
        },
        "activeFromDate":{
            "type":"string",
            "format":"datetime",
            "example":"2017-05-06T00:00:00"
        },
        "activeUntilDate":{
            "type":"string",
            "format":"datetime",
            "example":"2017-06-06T00:00:00"
        },
        "createdDate":{
            "type":"string",
            "format":"datetime",
            "example":"2013-06-17T18:27:01.843"
        },
        "createdBy":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/UserLink"
            }
        },
        "createdByUserId":{
            "type":"number",
            "example":123123
        },
        "lastUpdatedDate":{
            "type":"string",
            "format":"datetime",
            "example":"2018-03-20T05:00:01.553"
        },
        "lastUpdatedBy":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/UserLink"
            }
        },
        "lastUpdatedByUserId":{
            "type":"number",
            "example":123123
        },
        "onlyAllowOwnersToEditGroup":{
            "type":"boolean",
            "example":true
        },
        "selfServiceOptions":{
            "type":"string",
            "description":"enum for selfServiceOptions are: open, doesNotRequireApprovals, requiresApproval",
            "enum":[
                "open",
                "doesNotRequireApprovals",
                "requiresApproval"
            ],
            "example":"open"
        },
        "owners":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/GroupOwnerLink"
            }
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/GroupLink"
            }
        }
    }
}

Nested Schema : createdBy

Type: array

Show Source

• Array of: object UserLink

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/UserLink"
    }
}

Nested Schema : lastUpdatedBy

Type: array

Show Source

• Array of: object UserLink

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/UserLink"
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object GroupLink

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/GroupLink"
    }
}

Nested Schema : owners

Type: array

Show Source

• Array of: object GroupOwnerLink

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/GroupOwnerLink"
    }
}

Nested Schema : UserLink

Type: object

Show Source

• href(optional): string
  Example: {url}/learn.rest/v1/users/456
• rel(optional): string
  Example: canonical

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "example":"canonical"
        },
        "href":{
            "type":"string",
            "example":"{url}/learn.rest/v1/users/456"
        }
    }
}

Nested Schema : GroupLink

Type: object

Show Source

• href(optional): string
  Example: {url}/learn.rest/v1/learnCenters/{learnCenterId}/groups/{groupId}
• rel(optional): string
  Example: canonical

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "example":"canonical"
        },
        "href":{
            "type":"string",
            "example":"{url}/learn.rest/v1/learnCenters/{learnCenterId}/groups/{groupId}"
        }
    },
    "example":{
        "rel":"canonical",
        "href":"{url}/learn.rest/v1/learnCenters/178409/groups/456"
    }
}

Example:

{
    "rel":"canonical",
    "href":"{url}/learn.rest/v1/learnCenters/178409/groups/456"
}

Nested Schema : GroupOwnerLink

Type: object

Show Source

• href(optional): string
  Example: {url}/learn.rest/v1/learnCenter/178409/groups/456/owners/112867
• rel(optional): string
  Example: canonical

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "example":"canonical"
        },
        "href":{
            "type":"string",
            "example":"{url}/learn.rest/v1/learnCenter/178409/groups/456/owners/112867"
        }
    }
}

Back to Top