A good way to manage your students is to gather them into groups on our API. Il will provide you some convenient method to get aggregated results on a group.
A group can represent a class, or a formation session.
| Property | Type | Description |
|---|---|---|
| name | String | Custom data |
| instance_id | Integer | The instance this student group belongs to |
| student_cluster_id | Integer | The student cluster this student group belongs to |
| created_at | Timestamp | The creation date of the object |
| updated_at | Timestamp | The last update date of the object |
| Method | POST |
|---|---|
| URL | /student_groups |
| Property | Type | Description |
|---|---|---|
| name | String | Custom data |
| student_cluster_id | Integer | The student cluster this student group belongs to |
{
name: "2nd year associates financial services",
student_cluster_id: 1
}
{
id : 1,
name : "2nd year associates financial services",
student_cluster_id : 1,
instance_id : 1,
created_at : 2014-09-17 09:21:03,
updated_at : 2014-09-17 09:21:03
}
| Method | GET |
|---|---|
| URL | /student_groups/{student_group_id} |
If no student_group_id is provided it will fetch all the Student Groups for your instance.
With ID provided
{
id : 1,
name : "2nd year associates financial services",
student_cluster_id : 1,
instance_id : 1,
created_at : 2014-09-17 09:21:03,
updated_at : 2014-09-17 09:21:03
}
Without ID provided
[{
id : 1,
name : « 2nd year associates financial services »,
student_cluster_id : 1,
instance_id : 1,
created_at : 2014-09-17 09:21:03,
updated_at : 2014-09-17 09:21:03
},
{
id : 2,
name : « senior associates financial services »,
student_cluster_id : 1,
instance_id : 1,
created_at : 2014-09-17 09:21:03,
updated_at : 2014-09-17 09:21:03
}]
| Method | PUT |
|---|---|
| URL | /student_groups/{student_group_id} |
| Property | Type | Description/expected values |
|---|---|---|
| name | String | Custom data (<255 chars) |
| student_cluster_id | Integer | The student cluster this student group belongs to |
{
name : "No more 2nd year associates financial services"
}
{
id : 1, name : "No more 2nd year associates financial services", student_cluster_id : 1, instance_id : 1, created_at : 2014-09-17 09:21:03, updated_at : 2014-09-20 09:21:03
} </code>