---
title: "PATCH Questionnaire"
method: PATCH
path: "/v2/questionnaires/{questionnaire_id}"
tags: ["Questionnaires"]
---

# PATCH Questionnaire

`PATCH /v2/questionnaires/{questionnaire_id}`

Update a questionnaire. Provide at least one update field. Setting status to completed sets completed_at and triggers grading.

## Path parameters

- `questionnaire_id` string, required

## Request body

- object
  - `status` 'approved' | 'completed' — Questionnaire status. Use "approved" or "completed". Setting status to completed sets completed_at and triggers grading.
  - `due_at` string, date — Due date in YYYY-MM-DD format.
  - `assignee_email` string — Email of a user in the organization.
  - `notes` string, nullable — Internal notes. Send an empty string or null to clear.

## Response `200`

Updated questionnaire object.

- object
  - `id` string, uuid — Questionnaire identifier.
  - `name` string — Questionnaire name.
  - `status` string — Questionnaire status.
  - `assignee` object, nullable — Assigned user.
    - `name` string — Assignee display name.
    - `email` string, email — Assignee email address.
  - `due_at` string, date, nullable — Questionnaire due date.
  - `completed_at` string, date-time, nullable — When the questionnaire was completed.
  - `notes` string, nullable — Internal notes.
  - `product_lines` object[] — Product lines associated with the questionnaire.
    - `id` string, uuid — Product line identifier.
    - `name` string — Product line name.
  - `question_count` integer — Number of questions in the questionnaire.

## Other responses

- `400` — Invalid request.

---

[API](https://skmtc.net/conveyor/apis/portal-api.md) · [All operations](https://skmtc.net/conveyor/apis/portal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conveyor/portal-api/revisions/adc0da85b126/schema)