[BETA] Remove students from a group by external reference ID

Remove a student from a group identified by its external reference ID, without rewriting its membership. This endpoint never adds anyone. Same behaviour as DELETE /v3/groups/{id}/students, including the exhaustive list of cases where a student keeps their place on a course.

One student per call. Send studentIds or studentExternalReferenceIds, never both, with exactly one identifier. The field is an array so the limit can be raised later without breaking your integration. To replace a whole membership use PUT /v3/groups/{id}/students; to move a batch without touching courses use POST /v3/groups/students/batch-upsert.

Not idempotent, by design. Removing a student who is not a member of the group is rejected with STUDENT_NOT_IN_GROUP. Treat that code as benign if your events can be delivered more than once.

All or nothing. An unknown student identifier fails the whole call and writes nothing.

Rate limit: standard. Concurrency: two identical calls sent at the same moment share a single execution; a call replayed after the response has come back runs again in full.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length between 1 and 64

The external reference ID of the group

Query Params
boolean
Defaults to true

Optional, defaults to true. When true, the student is also removed from the attendance of the upcoming courses of the group, and the recipients of the surveys attached to those courses are updated. They stay on a course they also reach through another group they still belong to, which is why coursesUpdatedCount can be lower than the number of upcoming courses of the group. When false, only the group membership changes and the student stays on the course attendance - use this when your own system drives course attendance. Courses that have already started, and locked courses, are never affected either way.

Body Params
studentIds
array of strings

Internal Edusign student IDs to remove. Mutually exclusive with studentExternalReferenceIds.

studentIds
studentExternalReferenceIds
array of strings

External reference IDs (apiId) of the students to remove. Mutually exclusive with studentIds.

studentExternalReferenceIds
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json