Generic API

PATCH - Update API

This is a generic API that allows you to update various components of an evaluation platform:

You can update the question text to reflect any changes or corrections.
The marking scheme can be modified to adjust the scoring criteria.
Model answer step marking can be updated to ensure accurate evaluation.
Additionally, you can update the student evaluated answer marking for consistency

Scenario: Updating Question Text for Clarity or Correction:

Clarifying or Correcting Question Text:
- During the evaluation process, an evaluator identifies an ambiguous or incorrect question. The Generic Update API allows updating the question text to make it clearer or correct any inaccuracies.
- Outcome:
  - The question text is updated, ensuring consistency across the platform and more accurate evaluation for students.

Scenario: Adjusting the Marking Scheme for a Specific Question:

Modifying the Marking Scheme:
- An evaluator reviews a question and decides to adjust the marking scheme, either by changing the total marks, modifying the breakdown, or adding new criteria.
- Outcome:
  - The marking scheme is updated, ensuring fairness and alignment with evaluation criteria.

Scenario: Updating Model Answer’s Step Marking:

Modifying Step-Wise Marking:
- After reviewing the model answer, the evaluator notices the step marking needs to be adjusted for clarity or accuracy. The Generic Update API is used to modify how marks are distributed across different steps.
- Outcome:
  - The step marking is updated, impacting how student answers are evaluated and ensuring accurate scoring.

Scenario: Correcting Student Answer Evaluation Marking:

Correcting Mistakes in Evaluation:
- After reviewing a student’s answer, an error is discovered in the evaluation, such as incorrect marking or wrong application of the model answer’s step-wise evaluation.
- Outcome:
  - The student’s evaluated answer is corrected, ensuring that the final score accurately reflects the correct evaluation based on the model answer.

PATCH

evaluation-platform

exam

{examId}

update

curl --request PATCH \
  --url https://api-staging.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/update/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "entity": "modelAnswer",
    "id": "a17cd91d-55d3-46bb-a544-9f38ab2e027f",
    "text": "sdsdf",
    "stepMarking": [
      {
        "marksplit": 1,
        "step_wise_answer": "b"
      }
    ]
  },
  {
    "entity": "question",
    "id": "2f35d316-ed4e-430f-90e1-28ac133219f6",
    "text": "Titles adopted by the ruler-Devanampiya, often translated as '\''beloved of the gods'\'' and Piyadassi, or '\''pleasant to behold'\''. A. King Harshavardhan B. King Ashoka C. King Samudragupta D. King Chandragupta"
  }
]'

{
  "status": "Success",
  "message": "Data updated successfully"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

examId

string

required

Body

application/json · object[]

Request payload containing a list of entities, including model answers and questions.

entity

string

required

Type of entity (e.g., modelAnswer or question).

Example:

"modelAnswer"

string

required

Unique identifier for the entity.

Example:

"a17cd91d-55d3-46bb-a544-9f38ab2e027f"

text

string

required

The textual content of the entity.

Example:

"sdsdf"

stepMarking

object[]

List of step-wise marking details (only applicable to modelAnswer entities).

Response

200

application/json

Successful operation response indicating the data was updated successfully.

status

string

Indicates the status of the operation.

Example:

"Success"

message

string

Provides additional details about the operation result.

Example:

"Data updated successfully"

GET - Constants POST - Embeddable UI Link

curl --request PATCH \
  --url https://api-staging.crazygoldfish.com/evaluation-platform/v1/exam/{examId}/update/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "entity": "modelAnswer",
    "id": "a17cd91d-55d3-46bb-a544-9f38ab2e027f",
    "text": "sdsdf",
    "stepMarking": [
      {
        "marksplit": 1,
        "step_wise_answer": "b"
      }
    ]
  },
  {
    "entity": "question",
    "id": "2f35d316-ed4e-430f-90e1-28ac133219f6",
    "text": "Titles adopted by the ruler-Devanampiya, often translated as '\''beloved of the gods'\'' and Piyadassi, or '\''pleasant to behold'\''. A. King Harshavardhan B. King Ashoka C. King Samudragupta D. King Chandragupta"
  }
]'

{
  "status": "Success",
  "message": "Data updated successfully"
}

Authentication

K12

Assessment Rubrics

Standardized Language Exams

PATCH - Update API

Authorizations

Path Parameters

Body

Response