Edit Criterion

Update the text or importance of an existing criterion

PATCH /v1/jobs/{jobId}/criteria/items/{criterionId}

@nova-sdk/api

TypeScript

import { Nova } from "@nova-sdk/api";

const nova = new Nova({
  apiKey: "sk_test_...",
  tenantId: "acme-corp",
});

const result = await nova.jobs.criteria.items.update({
  jobId: "job_abc123",
  criterionId: "crit_abc123",
  body: { importance: "MUST_HAVE" },
});

200

{
  "criterion": {
    "id": "<string>",
    "text": "<string>",
    "order": 123,
    "createdAt": "2023-11-07T05:31:56Z"
  },
  "criteria": [
    {
      "id": "<string>",
      "text": "<string>",
      "order": 123,
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Existing scores aren’t affected. A new criteria version is created when you edit a criterion. Only future score requests use the updated criteria.

When to Use

Edit a criterion when you need to refine an existing requirement:

Adjust Importance

Change a criterion from NICE_TO_HAVE to MUST_HAVE (or vice versa) based on applicant pool quality

Clarify Wording

Make the criterion more specific or easier to evaluate

Partial Updates

You can update just the text, just the importance, or both. At least one field must be provided.

Update Importance Only

{
  "importance": "MUST_HAVE"
}

Update Text Only

{
  "text": "7+ years of software engineering experience in backend systems"
}

Update Both

{
  "text": "Strong proficiency in Go for backend development",
  "importance": "MUST_HAVE"
}

Response

The response includes the full criteria list after the edit, making it easy to update your UI without a separate GET request.

Authorizations

Authorization · string · header · required

Use Authorization: Bearer sk_test_* or Authorization: Bearer sk_live_*.

Headers

X-Tenant-Id · string · required

Your customer identifier. Tenants are auto-provisioned on first request.

Idempotency-Key · string

Optional key that makes criteria and library mutation requests safe to retry without duplicating side effects. The namespace is shared across all API keys for the same partner and environment. Reuse the same key when retrying the same request parameters.

Required string length: 1 - 255

Path Parameters

jobId · string · required

Your job identifier (external ID).

criterionId · string · required

Criterion ID.

Body

application/json

Option 1

Option 2

text · string · required

Minimum string length: 1

importance · enum<string>

Available options: MUST_HAVE, PREFERRED, NICE_TO_HAVE

Response

200

application/json

Updated

criterion · object · required

Show child attributes

criteria · object[] · required

Show child attributes