---
title: "Add/remove students from a reallocation group (legacy PATCH /reports/reallocation/students)"
method: PATCH
path: "/reports/reallocation/students"
tags: ["Reports"]
---

# Add/remove students from a reallocation group (legacy PATCH /reports/reallocation/students)

`PATCH /reports/reallocation/students`

**Requires permission:** *ReportAdmins*

Removes the supplied entries and inserts a new entry per added pupil, seeding each new entry's mark-grades from the group's existing grade fields. Port of the legacy RPT_RA_MarkGradesForStep / RPT_RA_DeleteEntry / RPT_InsertEntry / RPT_InsertMarkGrade chain.

## Request body

- ReallocateStudentRequest
  - `staffSteps` ReportReallocationStaffSteps
    - `name` string, nullable
    - `staffName` string, nullable
    - `stepId` integer
    - `reportId` integer
    - `number` integer
    - `staffId` integer
    - `deleteConfirm` boolean
    - `complete` integer
    - `total` integer
  - `studentsToAdd` ReallocateStudentEntry[]
    - `id` integer
    - `student` ReportStudentDto
      - `nameId` integer
      - `pupilId` integer
      - `preferredName` string, nullable
      - `surname` string, nullable
      - `studentUpi` string, guid, nullable
      - `emailAddress` string, nullable
      - `photo` string, nullable
  - `studentsToRemove` ReallocateStudentEntry[]
    - `id` integer
    - `student` ReportStudentDto
      - `nameId` integer
      - `pupilId` integer
      - `preferredName` string, nullable
      - `surname` string, nullable
      - `studentUpi` string, guid, nullable
      - `emailAddress` string, nullable
      - `photo` string, nullable

## Response `204`

Success - Reallocated

## Other responses

- `400` — An Error Occurred - Could not reallocate
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/versions/28344aa564b4/schema)