---
title: "Update questionnaire"
method: PATCH
path: "/customer-trust/questionnaires/{questionnaireId}"
tags: ["Customer Trust"]
---

# Update questionnaire

`PATCH /customer-trust/questionnaires/{questionnaireId}`

Update an existing questionnaire.

Updates one or more fields of a questionnaire.
This endpoint cannot be used to set a questionnaire's status to `APPROVED` or `COMPLETED`. To perform those specific transitions, please use the `approveQuestionnaire` and `completeQuestionnaire` endpoints, respectively.

## Path parameters

- `questionnaireId` string, required

## Request body

- UpdateQuestionnaireArgs
  - `displayName` string — Display name of the questionnaire
  - `dueDate` string, nullable — Due date for questionnaire completion (ISO 8601 string, null to clear)
  - `status` 'IN_PROGRESS' | 'IN_REVIEW' | 'READY_FOR_REVIEW' | 'WAITING_ON_ANSWERS' | 'ON_HOLD' | 'NO_LONGER_NEEDED'
  - `ownerAssignment` UpdateActorAssignment — Actor assignment for setting an owner or approver.
    - `type` 'User' | 'Team', required — The type of actor: "User" for an individual user, "Team" for a team.
    - `id` string, required — The unique identifier of the user or team.
  - `approverAssignment` UpdateActorAssignment — Actor assignment for setting an owner or approver.
    - `type` 'User' | 'Team', required — The type of actor: "User" for an individual user, "Team" for a team.
    - `id` string, required — The unique identifier of the user or team.
  - `metadata` QuestionnaireMetadata[] — Metadata key-value pairs
    - `key` string, required
    - `value` string, required
  - `tagAndCategoryIds` TagInput[] — Tags to assign to the questionnaire. Each entry must include a categoryId and tagId. Replaces all existing tags.
    - `categoryId` string, required
    - `tagId` string, required

## Response `200`

Ok

- CustomerTrustQuestionnaire
  - `id` string, required
  - `displayName` string, required
  - `url` string
  - `type` 'SPREADSHEET' | 'WEBSITE' | 'DOCUMENT', required
  - `status` 'APPROVED' | 'IN_PROGRESS' | 'IN_REVIEW' | 'READY_FOR_REVIEW' | 'WAITING_ON_ANSWERS' | 'ON_HOLD' | 'NO_LONGER_NEEDED' | 'COMPLETE' | 'ERROR' | 'EXTRACTING_QUESTIONS' | 'QUEUED_FOR_EXTRACTION' | 'PROCESSING' | 'QUEUED_FOR_PROCESSING' | 'WAITING_ON_COLUMN_SELECTION' | 'WAITING_ON_COLUMN_APPROVAL' | 'QUEUED_FOR_COLUMN_DETECTION' | 'DETECTING_COLUMNS', required
  - `statusLog` QuestionnaireStatusChangeEntry[], required — The status change history log for the questionnaire. Entries are ordered by the most recent status change first.
    - `updatedBy` QuestionnaireUser, required
      - `id` string, required
      - `displayName` string, nullable, required
      - `email` string, nullable, required
    - `updatedAt` string, date-time, required — The date and time when the status was changed
    - `status` 'APPROVED' | 'IN_PROGRESS' | 'IN_REVIEW' | 'READY_FOR_REVIEW' | 'WAITING_ON_ANSWERS' | 'ON_HOLD' | 'NO_LONGER_NEEDED' | 'COMPLETE' | 'ERROR' | 'EXTRACTING_QUESTIONS' | 'QUEUED_FOR_EXTRACTION' | 'PROCESSING' | 'QUEUED_FOR_PROCESSING' | 'WAITING_ON_COLUMN_SELECTION' | 'WAITING_ON_COLUMN_APPROVAL' | 'QUEUED_FOR_COLUMN_DETECTION' | 'DETECTING_COLUMNS', required
    - `message` string, nullable, required — An optional message associated with the status change
  - `ownerAssignment` ActorAssignment
    - `type` 'User' | 'Team', required
    - `id` string, required
    - `displayName` string, nullable, required
  - `approverAssignment` ActorAssignment
    - `type` 'User' | 'Team', required
    - `id` string, required
    - `displayName` string, nullable, required
  - `customerTrustAccountId` string
  - `dueDate` string, date-time
  - `metadata` object[]
    - `value` string, required
    - `key` string, required
  - `tagAndCategoryIds` TagInput[], required — Tags assigned to this questionnaire. Each entry contains a categoryId and tagId.
    - `categoryId` string, required
    - `tagId` string, required
  - `createdDate` string, date-time, required
  - `updatedDate` string, date-time, required
  - `completedDate` string, date-time

---

[API](https://skmtc.net/vanta/apis/build-integrations.md) · [All operations](https://skmtc.net/vanta/apis/build-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vanta/build-integrations/revisions/6c1f7590538b/schema)