Groups

Add students to a group

Changed on Oct 16, 2026

Idempotently add students to the group.

Per JSON:API to-many relationship POST semantics, this is idempotent: if the student is already a member, the existing membership is returned as succeeded — there is no separate already_a_member error code.

Within-batch duplicate detection is first-wins on id: the first occurrence is processed; subsequent occurrences are pre-marked duplicate_in_batch with the JSON:API source pointer at /data/{i}/id.

Returns 404 if the group is not in the caller's organization. The group lookup runs before the envelope guard so a missing group is reported as 404 regardless of body content — clients can't infer group existence from the 400-vs-404 boundary.

Required OAuth scope: student-groups:write

post/v2/groups/{id}/relationships/students/

Request

Base URL
https://api.skilljar.com (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/skilljar/apis/skilljar-api-v2/docs/v2/groups/:id/relationships/students/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

Request body

Response

Changes

Oct 16, 2026bed169429eb2 Revision changes
- warning
  added the new already_in_path enum value to the //// response property for the response status
- warning
  added the new already_in_path enum value to the //// response property for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
Sep 15, 20269fc34e55336d Revision changes
- info
  media type application/json was changed to a more specific media type application/vnd.api+json for the response status
- info
  media type application/json was changed to a more specific media type application/vnd.api+json for the response status
- info
  media type application/json was changed to a more specific media type application/vnd.api+json for the response status
- info
  media type application/json was changed to a more specific media type application/vnd.api+json for the response status
- info
  media type application/json was changed to a more specific media type application/vnd.api+json for the response status
- info
  media type application/json was changed to a more specific media type application/vnd.api+json for the response status
- info
  media type application/json was changed to a more specific media type application/vnd.api+json for the response status

Operation history