Skip to main content
GET
/
v1
/
jobs
/
{jobId}
/
question-sets
/
current
Get current question set
curl --request GET \
  --url https://embed.nova.dweet.com/v1/jobs/{jobId}/question-sets/current \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Tenant-Id: <x-tenant-id>'
{
  "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 did not 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 error 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