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");
curl -X GET "https://embed.nova.dweet.com/v1/jobs/job_abc123/criteria" \
  -H "Authorization: Bearer sk_test_..." \
  -H "X-Tenant-Id: acme-corp"
{
  "criteria": [
    {
      "id": "<string>",
      "text": "<string>",
      "order": 123,
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ]
}
{
  "type": "<string>",
  "status": 123,
  "message": "<string>",
  "retryable": true,
  "traceId": "<string>",
  "details": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}
{
  "type": "<string>",
  "status": 123,
  "message": "<string>",
  "retryable": true,
  "traceId": "<string>",
  "details": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}
{
  "type": "<string>",
  "status": 123,
  "message": "<string>",
  "retryable": true,
  "traceId": "<string>",
  "details": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}
{
  "type": "<string>",
  "status": 123,
  "message": "<string>",
  "retryable": true,
  "traceId": "<string>",
  "details": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

​
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