Skip to main content
GET
/
v1
/
jobs
/
{jobId}
/
question-sets
/
current
@nova-sdk/api
import { Nova } from "@nova-sdk/api";

const nova = new Nova({
  apiKey: "sk_test_...",
  tenantId: "acme-corp",
});

const result = await nova.jobs.questionSets.getCurrent("job_abc123");
{
  "questionSet": {
    "id": "<string>",
    "jobId": "<string>",
    "questions": [
      {
        "id": "<string>",
        "question": "<string>",
        "selectionType": "single",
        "options": [
          "<string>"
        ],
        "hint": "<string>"
      }
    ],
    "expiresAt": "2023-11-07T05:31:56Z",
    "guidance": "<string>"
  }
}
Retrieve the most recently generated question set for a job. Use this when you need to re-display questions without storing the questionSetId.

​
When to use

  • You didn’t store the questionSetId from the generation response
  • You want to show the latest questions in your UI after a page reload
  • You need to check whether questions have been generated for a job

​
Example response

{
  "questionSet": {
    "id": "cmlz26fn5003dwp61u6vmj4mc",
    "jobId": "job-123",
    "questions": [
      {
        "id": "q1",
        "selectionType": "single",
        "question": "What level of seniority are you targeting?",
        "options": ["Junior", "Mid", "Senior"],
        "hint": "Helps calibrate experience requirements"
      }
    ],
    "guidance": "Answer these questions to calibrate criteria generation.",
    "expiresAt": "2025-12-14T11:30:45Z"
  }
}
If no question set exists for the job, the endpoint returns a 404 with code QUESTION_SET_NOT_FOUND.

Generate Questions

Generate a new question set for a job

Get Question Set by ID

Retrieve a specific question set by its ID

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

Question set

​
questionSet
object
required