Criteria Library - Nova Documentation

The Criteria Library stores commonly-used screening criteria at the tenant level. Each tenant has their own isolated library.

Key behavior

Property	Detail
Tenant-scoped	Criteria aren’t shared across tenants
Copy-based	Adding a library criterion to a job creates an independent copy. Library changes don’t affect existing job criteria
Templates only	Library criteria aren’t used for scoring directly. Add them to a job first

Example workflow

// 1. Add criteria to the library
await fetch(`https://embed.nova.dweet.com/v1/criteria-library`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'X-Tenant-Id': tenantId,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    text: 'Demonstrated job stability with 2+ years average tenure',
    importance: 'NICE_TO_HAVE',
  }),
});

// 2. Add selected criteria to a job (creates independent copies)
await fetch(`https://embed.nova.dweet.com/v1/jobs/${jobId}/criteria/items`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'X-Tenant-Id': tenantId,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    text: 'Demonstrated job stability with 2+ years average tenure',
    importance: 'NICE_TO_HAVE',
  }),
});

Endpoints

List Library

Retrieve all criteria in the tenant’s library

Get Library Criterion

Retrieve a single criterion by ID

Add to Library

Save a new criterion

Update Library Criterion

Update a saved criterion

Remove from Library

Delete a criterion

Add to Job

Copy a library criterion to a job

Criteria Versioning Language

​Key behavior

​Example workflow

​Endpoints