---
title: "Update Question Set"
method: PATCH
path: "/v1/interviews/{interview_id}/question-sets/{set_id}"
tags: ["interviews"]
---

# Update Question Set

`PATCH /v1/interviews/{interview_id}/question-sets/{set_id}`

## Path parameters

- `interview_id` string, uuid, required
- `set_id` string, uuid, required

## Headers

- `X-API-Key` string, nullable

## Request body

- QuestionSetUpdate
  - `name` string, nullable
  - `description` string, nullable

## Response `200`

Successful Response

- QuestionSetOut
  - `id` string, uuid, required
  - `interview_id` string, uuid, required
  - `name` string, required
  - `description` string, nullable, required
  - `sort_order` integer, required
  - `topic_metadata` object, nullable
  - `questions` QuestionOut[]
    - `id` string, uuid, required
    - `question_set_id` string, uuid, required
    - `question_text` string, required
    - `is_required` boolean, required
    - `sort_order` integer, required
    - `question_type` 'open_ended' | 'single_choice' | 'multiple_choice' | 'likert_scale' | 'ranking' | 'statement' | 'range_slider' | 'matrix', required — Shape of an interview question — drives how the agent delivers and how answers get quantified.
    - `options` string[], required
    - `component_config` object, nullable
    - `follow_up_rule` 'auto' | 'none' | 'on_short_answers' | 'one_followup' | 'up_to_three' | 'no_followup_allowed', required — Per-question follow-up budget — controls how aggressively the agent probes.
    - `follow_up_guideline` string
    - `requires_screen_share` boolean
    - `screen_share_prompt` string
    - `created_at` string, date-time, required
  - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ontora/apis/ontora-api.md) · [All operations](https://skmtc.dev/ontora/apis/ontora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ontora/ontora-api/revisions/7f57037fd94b/schema)
