Skip to main content
POST
/
v1
/
jobs
/
{jobId}
/
criteria
/
archive
cURL
curl --request POST \
  --url https://embed.nova.dweet.com/v1/jobs/{jobId}/criteria/archive \
  --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"
}
After archiving, any attempt to score candidates for this job will return a CRITERIA_NOT_FOUND error. Existing scores and their criteria are preserved for audit purposes.

When to Archive

Archive criteria when:
  • Job posting is closed - No more candidates will be scored
  • Job was created in error - Clean up test or mistaken criteria
  • Moving to completely new requirements - Archive old criteria before generating new ones

What Happens

When you archive criteria:
  1. The criteria status changes to archived
  2. New scoring requests for this job will fail with CRITERIA_NOT_FOUND
  3. All historical scores retain their criteria for audit purposes
  4. The criteria can no longer be updated

Restoring Archived Criteria

To restore scoring for a job with archived criteria, call Generate Criteria again to create a new criteria set.

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

Response

Criteria archived 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