Students and customersStudent comments

Student comments

Students and customers · 3 операції

GET

List student comments

/api/student/comment/{id}

Comments left by staff on a student card, newest first.

list_student_comments

Параметри шляху · 1

idnumberобовʼязковий—

Відповідь · 200

application/json

statusCodenumberобовʼязковийприклад 200
messagestringобовʼязковий—
dataobject[]11 полів
commentIdnumberобовʼязковий—
studentIdnumberобовʼязковийможе бути null—
teacherIdnumberобовʼязковийможе бути null—
groupIdnumberобовʼязковийможе бути null—
customerIdnumberобовʼязковийможе бути null—
textstringобовʼязковий—
userobjectобовʼязковийможе бути nullComment author: a user or an automation rule; exactly one is set.5 полів
idnumberобовʼязковий—
firstNamestringобовʼязковий—
lastNamestringобовʼязковийможе бути null—
middleNamestringобовʼязковийможе бути null—
isArchivalbooleanобовʼязковий—
automationobjectобовʼязковийможе бути null2 поля
automationIdnumberобовʼязковий—
namestringобовʼязковий—
filesobject[]обовʼязковий5 полів
storageFileIdnumberобовʼязковий—
keystringобовʼязковийSigned through GET /storage/presigned-url, under the comment section's rights.
namestringобовʼязковий—
mimeTypestringобовʼязковийможе бути null—
sizenumberобовʼязковийможе бути null—
updatedAtstringобовʼязковийформат YYYY-MM-DDTHH:mm:ss
createdAtstringобовʼязковийформат YYYY-MM-DDTHH:mm:ss
Помилки400401403429500
curl "https://your-school.rist.pro/api/student/comment/1" \
  -H "Authorization: Bearer $RIST_API_KEY"
Приклад відповіді · 200
{
  "statusCode": 200,
  "message": "Operation completed successfully",
  "data": [
    {
      "commentId": 1,
      "studentId": 1,
      "teacherId": 1,
      "groupId": 1,
      "customerId": 1,
      "text": "string",
      "user": {
        "id": 1,
        "firstName": "string",
        "lastName": "string",
        "middleName": "string",
        "isArchival": false
      },
      "automation": {
        "automationId": 1,
        "name": "string"
      },
      "files": [
        {
          "storageFileId": 1,
          "key": "string",
          "name": "string",
          "mimeType": "string",
          "size": 0
        }
      ],
      "updatedAt": "2026-11-09T14:30:00",
      "createdAt": "2026-11-09T14:30:00"
    }
  ]
}
POST

Add comment to student

/api/student/comment

Add a staff comment to a student card.

create_student_comment

Тіло запиту

application/json · object

studentIdnumberмін. 1
teacherIdnumberмін. 1
groupIdnumberмін. 1
customerIdnumberмін. 1
textstringможе бути nullMissing for a comment of files only: the global pipe turns empty text into null.довжина макс. 3000

Відповідь · 201

application/json

statusCodenumberобовʼязковийприклад 201
messagestringобовʼязковий—
dataobject11 полів
commentIdnumberобовʼязковий—
studentIdnumberобовʼязковийможе бути null—
teacherIdnumberобовʼязковийможе бути null—
groupIdnumberобовʼязковийможе бути null—
customerIdnumberобовʼязковийможе бути null—
textstringобовʼязковий—
userobjectобовʼязковийможе бути nullComment author: a user or an automation rule; exactly one is set.5 полів
idnumberобовʼязковий—
firstNamestringобовʼязковий—
lastNamestringобовʼязковийможе бути null—
middleNamestringобовʼязковийможе бути null—
isArchivalbooleanобовʼязковий—
automationobjectобовʼязковийможе бути null2 поля
automationIdnumberобовʼязковий—
namestringобовʼязковий—
filesobject[]обовʼязковий5 полів
storageFileIdnumberобовʼязковий—
keystringобовʼязковийSigned through GET /storage/presigned-url, under the comment section's rights.
namestringобовʼязковий—
mimeTypestringобовʼязковийможе бути null—
sizenumberобовʼязковийможе бути null—
updatedAtstringобовʼязковийформат YYYY-MM-DDTHH:mm:ss
createdAtstringобовʼязковийформат YYYY-MM-DDTHH:mm:ss
Помилки400401403429500
curl -X POST "https://your-school.rist.pro/api/student/comment" \
  -H "Authorization: Bearer $RIST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "studentId": 1,
    "teacherId": 1,
    "groupId": 1,
    "customerId": 1,
    "text": "string"
  }'
Приклад відповіді · 201
{
  "statusCode": 201,
  "message": "Operation completed successfully",
  "data": {
    "commentId": 1,
    "studentId": 1,
    "teacherId": 1,
    "groupId": 1,
    "customerId": 1,
    "text": "string",
    "user": {
      "id": 1,
      "firstName": "string",
      "lastName": "string",
      "middleName": "string",
      "isArchival": false
    },
    "automation": {
      "automationId": 1,
      "name": "string"
    },
    "files": [
      {
        "storageFileId": 1,
        "key": "string",
        "name": "string",
        "mimeType": "string",
        "size": 0
      }
    ],
    "updatedAt": "2026-11-09T14:30:00",
    "createdAt": "2026-11-09T14:30:00"
  }
}
PUT

Edit student comment

/api/student/comment/{id}

Replace the text of a student comment. The path id is the comment id (from GET /api/student/comment/{id}), not the student id.

update_student_comment

Параметри шляху · 1

idnumberобовʼязковий—

Тіло запиту

application/json · object

textstringобовʼязковийдовжина макс. 3000

Відповідь · 200

application/json

statusCodenumberобовʼязковийприклад 200
messagestringобовʼязковий—
dataobject11 полів
commentIdnumberобовʼязковий—
studentIdnumberобовʼязковийможе бути null—
teacherIdnumberобовʼязковийможе бути null—
groupIdnumberобовʼязковийможе бути null—
customerIdnumberобовʼязковийможе бути null—
textstringобовʼязковий—
userobjectобовʼязковийможе бути nullComment author: a user or an automation rule; exactly one is set.5 полів
idnumberобовʼязковий—
firstNamestringобовʼязковий—
lastNamestringобовʼязковийможе бути null—
middleNamestringобовʼязковийможе бути null—
isArchivalbooleanобовʼязковий—
automationobjectобовʼязковийможе бути null2 поля
automationIdnumberобовʼязковий—
namestringобовʼязковий—
filesobject[]обовʼязковий5 полів
storageFileIdnumberобовʼязковий—
keystringобовʼязковийSigned through GET /storage/presigned-url, under the comment section's rights.
namestringобовʼязковий—
mimeTypestringобовʼязковийможе бути null—
sizenumberобовʼязковийможе бути null—
updatedAtstringобовʼязковийформат YYYY-MM-DDTHH:mm:ss
createdAtstringобовʼязковийформат YYYY-MM-DDTHH:mm:ss
Помилки400401403429500
curl -X PUT "https://your-school.rist.pro/api/student/comment/1" \
  -H "Authorization: Bearer $RIST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
Приклад відповіді · 200
{
  "statusCode": 200,
  "message": "Operation completed successfully",
  "data": {
    "commentId": 1,
    "studentId": 1,
    "teacherId": 1,
    "groupId": 1,
    "customerId": 1,
    "text": "string",
    "user": {
      "id": 1,
      "firstName": "string",
      "lastName": "string",
      "middleName": "string",
      "isArchival": false
    },
    "automation": {
      "automationId": 1,
      "name": "string"
    },
    "files": [
      {
        "storageFileId": 1,
        "key": "string",
        "name": "string",
        "mimeType": "string",
        "size": 0
      }
    ],
    "updatedAt": "2026-11-09T14:30:00",
    "createdAt": "2026-11-09T14:30:00"
  }
}