Remove Criterion

Remove a single criterion from a job’s screening criteria

DELETE /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.remove({
  jobId: "job_abc123",
  criterionId: "crit_abc123",
});

200

{
  "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 remove a criterion. Only future score requests 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 applicants

Common Scenarios

Scenario	Action
Technology pivot	Remove criteria for deprecated tech stack
Budget change	Remove seniority requirements if hiring at different level
Team restructure	Remove criteria for responsibilities that moved to another role

Consider the impact on scoring consistency. Removing a MUST_HAVE criterion may significantly change how applications are evaluated compared to earlier applicants.

Response

Returns the remaining criteria after removal:

{
  "criteria": [
    {
      "id": "crit_a1b2c3d4e5f6",
      "text": "Strong proficiency in Go for backend development",
      "importance": "MUST_HAVE",
      "order": 0
    }
  ]
}

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.

Response

200

application/json

Removed

criteria · object[] · required

Show child attributes