Documentation

CreateGroupCategoryDTO extends AbstractBaseDto

Data Transfer Object for creating a group category in Canvas LMS.

Table of Contents

Properties

$autoLeader  : string|null
Assigns group leaders automatically Values: 'first', 'random', null
$courseId  : int|null
Course ID for creating group category in course context
$createGroupCount  : int|null
Create this number of groups
$groupLimit  : int|null
Limit the maximum number of users in each group Requires self signup
$name  : string|null
Name of the group category (required)
$nonCollaborative  : bool|null
Can only be set by users with Differentiation Tag permissions If true, groups will only be visible to users with manage permission
$selfSignup  : string|null
Allow students to sign up for a group themselves Values: 'enabled', 'restricted', null
$sisGroupCategoryId  : string|null
The unique SIS identifier
$splitGroupCount  : string|null
(Deprecated) Create groups and evenly distribute students
$apiPropertyName  : string
The name of the property in the API

Methods

__construct()  : mixed
BaseDto constructor.
toApiArray()  : array<string|int, array{name: string, contents: string}>
Convert DTO to API-compatible array format
toArray()  : array<string|int, mixed>
Convert the DTO to an array

Properties

$autoLeader

Assigns group leaders automatically Values: 'first', 'random', null

public string|null $autoLeader = null

$courseId

Course ID for creating group category in course context

public int|null $courseId = null

$groupLimit

Limit the maximum number of users in each group Requires self signup

public int|null $groupLimit = null

$nonCollaborative

Can only be set by users with Differentiation Tag permissions If true, groups will only be visible to users with manage permission

public bool|null $nonCollaborative = null

$selfSignup

Allow students to sign up for a group themselves Values: 'enabled', 'restricted', null

public string|null $selfSignup = null

$splitGroupCount

(Deprecated) Create groups and evenly distribute students

Use assign_unassigned_members endpoint instead

public string|null $splitGroupCount = null

$apiPropertyName

The name of the property in the API

protected string $apiPropertyName = ''

Methods

__construct()

BaseDto constructor.

public __construct(array<string|int, mixed> $data) : mixed
Parameters
$data : array<string|int, mixed>
Tags
throws
Exception

toApiArray()

Convert DTO to API-compatible array format

public toApiArray() : array<string|int, array{name: string, contents: string}>
Return values
array<string|int, array{name: string, contents: string}>

toArray()

Convert the DTO to an array

public toArray() : array<string|int, mixed>
Return values
array<string|int, mixed>

        
On this page

Search results