> ## Documentation Index > Fetch the complete documentation index at: https://docs.evalezy.com/llms.txt > Use this file to discover all available pages before exploring further. # Update several rubrics > Sets or clears the rubric and/or model answer of several long-answer questions in one version bump. The body maps question ids to `{rubric, model_answer}`; send `null` to clear one. Criterion marks must add up to the question's max marks (422 `rubric_marks_mismatch`), names must be unique (422 `rubric_duplicate_criterion`) and guidance must not contain mark figures (422 `rubric_guidance_has_marks`). Send `If-Match` with the version you read to avoid overwriting someone else's change. **Scope:** `evaluation:write` ## OpenAPI ````yaml /api-reference/openapi.json patch /exams/{examId}/rubrics openapi: 3.0.1 info: title: Evalezy AI Evaluation API version: v1 description: >- Create exams, register candidates, submit scanned answer copies or typed answers, and read question-wise AI marks with feedback. Results are drafts until you finalize them. Server-to-server only: never ship an API key inside a browser or mobile app. English answers only for now (Hindi and regional languages are on the roadmap). contact: name: Evalezy email: hello@evalezy.com url: https://evalezy.com servers: - url: https://api.evalezy.com/v1 description: Production security: - ApiKey: [] tags: - name: Exams description: Create, open, edit and look up exams. - name: Questions description: Add, edit and remove the questions of an exam. - name: Rubrics description: Marking criteria and model answers for long-answer questions. - name: Choice groups description: Internal choice ("attempt any N of M"). Beta, enabled on request. - name: Candidates description: >- Your students, keyed by your own external_id, and their exam registrations. - name: Uploads description: Presigned uploads for scanned answer copies (PDF). - name: Submissions description: Submit a copy or typed answers for a candidate and track its evaluation. - name: Results description: Question-wise marks, feedback and the checked (annotated) copy. - name: Review description: Teacher overrides, approval, finalize and unfinalize. - name: Credits description: Credit balance, rate card and price quotes. - name: Account description: Check which institute and scopes an API key has. paths: /exams/{examId}/rubrics: patch: tags: - Rubrics summary: Update several rubrics description: >- Sets or clears the rubric and/or model answer of several long-answer questions in one version bump. The body maps question ids to `{rubric, model_answer}`; send `null` to clear one. Criterion marks must add up to the question's max marks (422 `rubric_marks_mismatch`), names must be unique (422 `rubric_duplicate_criterion`) and guidance must not contain mark figures (422 `rubric_guidance_has_marks`). Send `If-Match` with the version you read to avoid overwriting someone else's change. **Scope:** `evaluation:write` operationId: updateRubrics parameters: - name: examId in: path required: true schema: type: string format: uuid description: Exam id (UUID). - name: If-Match in: header required: false schema: type: string example: '3' description: >- Optional. The rubric version you last read, e.g. `3`. If the rubric has moved on, the call fails with 412 `rubric_version_mismatch`. requestBody: content: application/json: schema: $ref: '#/components/schemas/JsonNode' example: questions: b2e1d3c5-7f9a-4b4d-8e6f-0a2c3d4e5f6a: rubric: partial_marking: true criteria: - name: Role of hydrochloric acid marks: 1 guidance: Acidic medium, kills germs, activates pepsin. - name: Enzymes named marks: 1 keywords: - pepsin guidance: Pepsin digests proteins. - name: Mucus and protection marks: 1 guidance: Mucus protects the inner lining from the acid. d3f2e4c6-8a0b-4c5e-9f7a-1b3d4e5f6a7b: model_answer: null required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RubricWriteResult' example: version: 4 questions: - question_id: b2e1d3c5-7f9a-4b4d-8e6f-0a2c3d4e5f6a '401': $ref: '#/components/responses/Error401' '403': $ref: '#/components/responses/Error403' '404': $ref: '#/components/responses/Error404' '409': $ref: '#/components/responses/Error409' '412': $ref: '#/components/responses/Error412' '422': $ref: '#/components/responses/Error422' '429': $ref: '#/components/responses/Error429' components: schemas: JsonNode: type: object RubricWriteResult: type: object properties: version: type: integer nullable: true description: New rubric version (null while `sync` is `pending`). sync: type: string description: '`pending` when the change is saved but still syncing.' question: type: object description: 'PUT: the question''s rubric view.' questions: type: array items: type: object description: 'PATCH: one entry per changed question.' warnings: type: array items: $ref: '#/components/schemas/Warning' Warning: type: object description: >- A non-fatal note about the request, e.g. `auto_rubric` or `pages_beyond_vision_limit`. properties: code: type: string message: type: string field: type: string nullable: true Error: type: object description: >- Every error uses this envelope. Branch on `error.code`; the message is for humans. properties: error: type: object properties: code: type: string description: Stable machine code, e.g. `validation_failed`. example: validation_failed message: type: string description: Human-readable explanation. example: questions[1].max_marks must be a multiple of 0.5. request_id: type: string description: >- Quote this when you contact support (also sent as the X-Request-Id header). details: type: object description: >- Extra context. For `validation_failed`, `details.errors` lists every failing field. additionalProperties: true responses: Error401: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: invalid_api_key message: The API key is not valid. request_id: req_4f9c2a7e1b3d4c8a9e6f0b2d5a7c1e3f Error403: description: >- The key lacks the required scope, or the API is not enabled for the institute. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: insufficient_scope message: This API key lacks the evaluation:write scope. request_id: req_4f9c2a7e1b3d4c8a9e6f0b2d5a7c1e3f details: required_scope: evaluation:write Error404: description: Not found (ids of other institutes are also 404). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: not_found message: The resource was not found. request_id: req_4f9c2a7e1b3d4c8a9e6f0b2d5a7c1e3f Error409: description: Conflict with the current state. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: conflict message: The request conflicts with the current state. request_id: req_4f9c2a7e1b3d4c8a9e6f0b2d5a7c1e3f Error412: description: The rubric is at a different version than If-Match. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: rubric_version_mismatch message: The rubric is at version 4, not 3. Re-read it and retry. request_id: req_4f9c2a7e1b3d4c8a9e6f0b2d5a7c1e3f Error422: description: The request is valid JSON but breaks a rule. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: validation_failed message: questions[0].max_marks is required. request_id: req_4f9c2a7e1b3d4c8a9e6f0b2d5a7c1e3f details: errors: - field: questions[0].max_marks code: required message: max_marks is required. Error429: description: Rate limit or daily quota reached. Retry after the Retry-After header. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: rate_limited message: Too many requests. Retry after 2 s. request_id: req_4f9c2a7e1b3d4c8a9e6f0b2d5a7c1e3f securitySchemes: ApiKey: type: apiKey in: header name: X-API-Key description: >- Your institute's API key, `vak_eval_` followed by 48 hex characters. An institute admin creates keys in the dashboard under Settings -> Integrations -> API keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.