Skip to main content
DELETE
/
v1
/
jobs
/
{jobId}
/
criteria
/
{criterionId}
cURL
curl --request DELETE \
  --url https://embed.nova.dweet.com/v1/jobs/{jobId}/criteria/{criterionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Tenant-Id: <x-tenant-id>'
{
  "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 remove a criterion. Only future score requests will use the updated criteria.

​
When to Use

Remove a criterion when it’s no longer relevant to the role:

Requirement Changed

A skill or qualification is no longer needed for the position

Too Restrictive

The criterion is filtering out otherwise qualified candidates

​
Common Scenarios

ScenarioAction
Technology pivotRemove criteria for deprecated tech stack
Budget changeRemove seniority requirements if hiring at different level
Team restructureRemove criteria for responsibilities that moved to another role
Consider the impact on scoring consistency. Removing a MUST_HAVE criterion may significantly change how candidates are evaluated compared to earlier applicants.

​
Response

The response includes the full criteria list after the removal, 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 remove

Response

Criterion removed 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