Skip to main content
GET
/
v1
/
jobs
/
{jobId}
/
criteria
@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.list("job_abc123");
{
  "criteria": [
    {
      "id": "<string>",
      "text": "<string>",
      "importance": "MUST_HAVE",
      "order": 123
    }
  ]
}

When to Use

Retrieve the current criteria stored for a job. Useful for:
  • Displaying criteria in your UI for review
  • Debugging scoring behavior
  • Verifying criteria were stored correctly after generation
  • Building admin tools to manage criteria

Example response

{
  "criteria": [
    {
      "id": "crit_a1b2c3d4e5f6",
      "text": "Strong proficiency in Go for backend development",
      "importance": "MUST_HAVE",
      "order": 0
    },
    {
      "id": "crit_f6e5d4c3b2a1",
      "text": "Experience with distributed systems",
      "importance": "PREFERRED",
      "order": 1
    }
  ]
}

Get Current Version

Get active criteria with version metadata

Add Criterion

Add a new criterion

Archive Criteria

Archive criteria when a job closes

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.

Path Parameters

jobId
string
required

Your job identifier (external ID).

Response

Active criteria

criteria
object[]
required