Skip to main content
PATCH
/
v1
/
jobs
/
{jobId}
/
criteria
/
{criterionId}
Edit a criterion
curl --request PATCH \
  --url https://embed.nova.dweet.com/v1/jobs/{jobId}/criteria/{criterionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Tenant-Id: <x-tenant-id>' \
  --data '
{
  "text": "<string>",
  "importance": "MUST_HAVE"
}
'
{
  "jobId": "<string>",
  "criteria": [
    {
      "id": "<string>",
      "text": "<string>",
      "importance": "MUST_HAVE"
    }
  ],
  "status": "active",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}
Existing scores are not affected. A new criteria version is created when you edit a criterion. Only future score requests will use the updated criteria.

​
When to Use

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

Adjust Importance

Change a criterion from PREFERRED 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

API key authentication. Use your environment-specific API key (sk_test_* for sandbox, sk_live_* for production).

Headers

​
X-Tenant-Id
string
required

Your customer/tenant identifier. Used for data isolation and per-customer metrics. Tenants are created automatically on first request.

Path Parameters

​
jobId
string
required

Your job ID

​
criterionId
string
required

The criterion ID to edit

Body

application/json

At least one of text or importance must be provided.

​
text
string

Updated criterion text

​
importance
enum<string>

Updated importance level

Available options:
MUST_HAVE,
PREFERRED,
NICE_TO_HAVE

Response

Criterion updated successfully

​
jobId
string
required

Your job ID

​
criteria
object[]
required

The screening criteria for this job

​
status
enum<string>
required

Criteria status. Archived criteria cannot be used for new scoring requests.

Available options:
active,
archived
​
createdAt
string<date-time>
required

When the criteria were originally created

​
updatedAt
string<date-time>
required

When the criteria were last modified