Subject
Gets a paginated list of Subjects for the calling organisation(s), sorted by id. Archived Subjects are added when includeArchived is true.
Type "Bearer" followed by a space and a token.
OK
Bad Request
Not Found
Internal Server Error
GET /api/v1/Groups/Subject HTTP/1.1
Host: publicapi-eu.schoolsbuddy.net
Authorization: YOUR_API_KEY
Accept: */*
{
"isSuccess": true,
"errors": [
"text"
],
"messageTranslationParameters": null,
"data": [
{
"id": 1,
"organisationId": 1,
"name": "text",
"isArchived": true,
"createdAtUtc": "2026-01-01T00:00:00.000Z",
"updatedAtUtc": "2026-01-01T00:00:00.000Z",
"thirdPartyId": "text",
"isImported": true
}
],
"pageNumber": 1,
"pageSize": 1,
"firstPage": "https://example.com",
"lastPage": "https://example.com",
"totalPages": 1,
"totalRecords": 1,
"nextPage": "https://example.com",
"previousPage": "https://example.com",
"baseUri": "https://example.com",
"searchParameters": [
{
"key": "text",
"value": "text"
}
]
}Creates a Subject. The Subject always starts unarchived and is never import-managed (ThirdPartyId is not set).
Type "Bearer" followed by a space and a token.
The organisation to create the Subject in — required when the client has access to multiple organisations
Created
Bad Request
Not Found
Internal Server Error
POST /api/v1/Groups/Subject HTTP/1.1
Host: publicapi-eu.schoolsbuddy.net
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 15
{
"name": "text"
}{
"id": 1,
"organisationId": 1,
"name": "text",
"isArchived": true,
"createdAtUtc": "2026-01-01T00:00:00.000Z",
"updatedAtUtc": "2026-01-01T00:00:00.000Z",
"thirdPartyId": "text",
"isImported": true
}Gets a single Subject by id. Archived Subjects return 404 SUBJECT_NOT_FOUND (§11).
Type "Bearer" followed by a space and a token.
The Subject id (Subject.Id)
The organisation to look the Subject up in — required when the client has access to multiple organisations
OK
Bad Request
Not Found
Internal Server Error
GET /api/v1/Groups/Subject/{id} HTTP/1.1
Host: publicapi-eu.schoolsbuddy.net
Authorization: YOUR_API_KEY
Accept: */*
{
"id": 1,
"organisationId": 1,
"name": "text",
"isArchived": true,
"createdAtUtc": "2026-01-01T00:00:00.000Z",
"updatedAtUtc": "2026-01-01T00:00:00.000Z",
"thirdPartyId": "text",
"isImported": true
}Partially updates a Subject — omitted fields preserve their existing values (§3.7e). The URL {id} is the canonical identifier; the body carries no id. Setting isArchived = true cascade-archives the Subject's active SubjectClasses. Sending isArchived = false unarchives an archived Subject with no class cascade (EC-1 as amended 2026-07-31); any other write against an archived Subject returns 409 RESOURCE_ARCHIVED.
Type "Bearer" followed by a space and a token.
The Subject id (Subject.Id)
The organisation the Subject belongs to — required when the client has access to multiple organisations
OK
Bad Request
Not Found
Internal Server Error
PUT /api/v1/Groups/Subject/{id} HTTP/1.1
Host: publicapi-eu.schoolsbuddy.net
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 33
{
"name": "text",
"isArchived": true
}{
"id": 1,
"organisationId": 1,
"name": "text",
"isArchived": true,
"createdAtUtc": "2026-01-01T00:00:00.000Z",
"updatedAtUtc": "2026-01-01T00:00:00.000Z",
"thirdPartyId": "text",
"isImported": true
}Creates Subjects in bulk. Items are processed independently — per-item failures are reported in failedItems[] and do not roll back the other items.
Type "Bearer" followed by a space and a token.
Request body for POST /api/v1/Groups/Subject/BulkCreate (SB-15450). The envelope-level organisationId scopes every item in the batch (cross-cutting §3.8.1) — items are not individually org-addressable.
Gets or sets the organisation the batch operates on. Optional when the calling client has access to a single organisation; required for multi-org clients.
OK
Standard envelope returned by every Public API bulk endpoint (BulkCreate / BulkUpdate / BulkArchive). Each item in the request is processed independently — one item failing does not roll back the others — and the envelope reports per-item outcome. See cross-cutting-design.md §4.
Gets or sets the ids of the items that were processed successfully. On BulkCreate these are the newly-created ids.
Gets or sets the total number of items in the request. Set by the caller (it is not derivable from the success/failure lists alone — items rejected before per-item processing may appear in neither).
Gets the number of items processed successfully (computed).
Gets the number of items that failed (computed).
Bad Request
Not Found
Internal Server Error
POST /api/v1/Groups/Subject/BulkCreate HTTP/1.1
Host: publicapi-eu.schoolsbuddy.net
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 73
{
"organisationId": 1,
"items": [
{
"name": "text",
"clientReferenceId": "text"
}
]
}{
"successfulIds": [
1
],
"failedItems": [
{
"index": 1,
"clientReferenceId": "text",
"name": "text",
"code": "text",
"error": "text"
}
],
"totalRequested": 1,
"totalSuccessful": 1,
"totalFailed": 1
}Partially updates Subjects in bulk. Each item carries the target id; items are processed independently. An item carrying isArchived = false unarchives an archived Subject (EC-1 as amended 2026-07-31).
Type "Bearer" followed by a space and a token.
Request body for PUT /api/v1/Groups/Subject/BulkUpdate (SB-15450). The envelope-level organisationId scopes every item in the batch (cross-cutting §3.8.1).
Gets or sets the organisation the batch operates on. Optional when the calling client has access to a single organisation; required for multi-org clients.
OK
Standard envelope returned by every Public API bulk endpoint (BulkCreate / BulkUpdate / BulkArchive). Each item in the request is processed independently — one item failing does not roll back the others — and the envelope reports per-item outcome. See cross-cutting-design.md §4.
Gets or sets the ids of the items that were processed successfully. On BulkCreate these are the newly-created ids.
Gets or sets the total number of items in the request. Set by the caller (it is not derivable from the success/failure lists alone — items rejected before per-item processing may appear in neither).
Gets the number of items processed successfully (computed).
Gets the number of items that failed (computed).
Bad Request
Not Found
Internal Server Error
PUT /api/v1/Groups/Subject/BulkUpdate HTTP/1.1
Host: publicapi-eu.schoolsbuddy.net
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 98
{
"organisationId": 1,
"items": [
{
"name": "text",
"isArchived": true,
"id": 1,
"clientReferenceId": "text"
}
]
}{
"successfulIds": [
1
],
"failedItems": [
{
"index": 1,
"clientReferenceId": "text",
"name": "text",
"code": "text",
"error": "text"
}
],
"totalRequested": 1,
"totalSuccessful": 1,
"totalFailed": 1
}Archives or unarchives Subjects in bulk (toggleable via the isArchived body flag). Archiving cascade-archives each Subject's active SubjectClasses; unarchiving restores the Subject only. Alongside PUT / BulkUpdate items carrying isArchived = false, the write verbs allowed against already-archived Subjects (EC-1 as amended 2026-07-31).
Type "Bearer" followed by a space and a token.
Request body for POST /api/v1/Groups/Subject/BulkArchive (SB-15450). Toggleable: isArchived true archives (and cascade-archives each Subject's active SubjectClasses, archive-strategy §2.6), false unarchives the Subject only (no class cascade). BulkArchive and a PUT / BulkUpdate item carrying isArchived: false are the verbs allowed to operate on already-archived rows (EC-1 as amended 2026-07-31).
Gets or sets the organisation the batch operates on. Optional when the calling client has access to a single organisation; required for multi-org clients.
Gets or sets the ids (Subject.Id) of the Subjects to transition. Id validity is checked per item (EC-7) — 0 / negative ids fail that item only.
Gets or sets a value indicating whether the Subjects are archived (true, default) or unarchived (false).
OK
Standard envelope returned by every Public API bulk endpoint (BulkCreate / BulkUpdate / BulkArchive). Each item in the request is processed independently — one item failing does not roll back the others — and the envelope reports per-item outcome. See cross-cutting-design.md §4.
Gets or sets the ids of the items that were processed successfully. On BulkCreate these are the newly-created ids.
Gets or sets the total number of items in the request. Set by the caller (it is not derivable from the success/failure lists alone — items rejected before per-item processing may appear in neither).
Gets the number of items processed successfully (computed).
Gets the number of items that failed (computed).
Bad Request
Not Found
Internal Server Error
POST /api/v1/Groups/Subject/BulkArchive HTTP/1.1
Host: publicapi-eu.schoolsbuddy.net
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 48
{
"organisationId": 1,
"ids": [
1
],
"isArchived": true
}{
"successfulIds": [
1
],
"failedItems": [
{
"index": 1,
"clientReferenceId": "text",
"name": "text",
"code": "text",
"error": "text"
}
],
"totalRequested": 1,
"totalSuccessful": 1,
"totalFailed": 1
}Last updated