Skip to main content
PATCH
/
v1
/
jobs
/
{jobId}
/
criteria
/
items
/
{criterionId}
@nova-sdk/api
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" },
});
{
  "criterion": {
    "id": "<string>",
    "text": "<string>",
    "importance": "MUST_HAVE",
    "order": 123,
    "createdAt": "2023-11-07T05:31:56Z"
  },
  "criteria": [
    {
      "id": "<string>",
      "text": "<string>",
      "importance": "MUST_HAVE",
      "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 candidate 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. 
{
  "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
​
text
string
required
Minimum string length: 1
​
importance
enum<string>
Available options:
MUST_HAVE,
PREFERRED,
NICE_TO_HAVE

Response

Updated

​
criterion
object
required
​
criteria
object[]
required