**This is an old revision of the document!** ----
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.\\ {{ :api2:student:student_group.png?600 |Student Groups}} ===Object resources=== ^ Property ^ Type ^ Description ^ | name | String | Custom data | ===Create (POST)=== ^ Method | POST | ^ URL | /student_groups | ==Parameters (*Requiered parameters)== ^ Property ^ Type ^ Description ^ | name | String | Custom data | ==Send the request (JSON input example)== <code> { name : "2nd year associates financial services" } </code> ==Get the response (JSON output example)== <code> { id: 1, name: "2nd year associates financial services" } </code> ===Fetch (GET)=== ^ 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. ==Get the response (JSON output example)== **With ID provided**\\ <code> { id: 1, name: "2nd year associates financial services" } </code> **Without ID provided**\\ <code> [{ id: 1, name: "2nd year associates financial services" }, { id: 2, name: "senior associates financial services" }] </code> ===EDIT (PUT)=== ^ Method | PUT | ^ URL | /student_groups/{student_group_id} | ==Editable parameters== ^ Property ^ Type ^ Description/expected values | | name | String | Custom data (<255 chars) | ==Send the request (JSON input example)== <code> { name : "No more 2nd year associates financial services" } </code> ==Get the response (JSON output example)== <code> { id: 1, name: "No more 2nd year associates financial services" } </code>
