---
title: "Update Question"
method: PUT
path: "/api/frameworks/questions/{question_id}"
tags: ["frameworks"]
---

# Update Question

`PUT /api/frameworks/questions/{question_id}`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/frameworks/questions/{question_id}`
- Auth: HTTP bearer

Update an organization's custom question.
Cannot update system default questions.

## Path parameters

- `question_id` string, required

## Request body

- QuestionUpdate
  - `question_text` string, nullable
  - `category` string, nullable
  - `career_phase` string, nullable
  - `probing_questions` string[], nullable
  - `what_to_listen_for` string[], nullable
  - `competency_id` string, nullable
  - `is_active` boolean, nullable

## Response `200`

Successful Response

- QuestionResponse
  - `question_text` string, required
  - `category` string, nullable
  - `career_phase` string, nullable
  - `probing_questions` string[], nullable
  - `what_to_listen_for` string[], nullable
  - `id` string, required
  - `framework_code` string, required
  - `competency_id` string, nullable
  - `competency_name` string, nullable
  - `organization_id` string, nullable
  - `is_system_default` boolean, required
  - `source` string, required
  - `is_active` boolean, required
  - `usage_count` integer, required
  - `created_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)