Skip to main content
GET
/
v1
/
jobs
/
{jobId}
/
question-sets
/
{questionSetId}
@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.get({
  jobId: "job_abc123",
  questionSetId: "qs_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 a specific question set by its ID. Use this when you have stored the questionSetId from a previous generation response and need to fetch the questions again.

​
When to use

  • You stored the questionSetId and need to re-display questions
  • You want to verify the questions before passing answers to criteria generation
  • You need to check expiresAt to confirm the question set is still valid

​
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 the question set doesn’t exist, the endpoint returns a 404 error with code QUESTION_SET_NOT_FOUND.

Generate Questions

Generate a new question set for a job

Get Current Question Set

Retrieve the latest question set without knowing the 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).

​
questionSetId
string
required

Question set ID.

Response

Question set

​
questionSet
object
required