---
title: "Update GTKY answer visibility for a new hire packet"
method: PUT
path: "/api/v1/new-hire-packets/{id}/question-visibility"
tags: ["Onboarding", "Public API"]
---

# Update GTKY answer visibility for a new hire packet

`PUT /api/v1/new-hire-packets/{id}/question-visibility`

Shows or hides get-to-know-you (GTKY) question answers for the packet. Omit questionIds to toggle all answers (same as the legacy BFF POST /onboarding/questions/visibility/{newHirePacketId} with a visible query flag). Send questionIds to toggle only specific personal questions linked to this new hire packet. Requires the same edit access as other NHP writes. When the employee has a hire date set, updates are rejected once the company-local calendar date is on or after that date (same rule as GET /onboarding/questions/{newHirePacketId}, which redirects to expired in that case). Draft employees without a hire date are not blocked.

OAuth Scopes: onboarding.write

## Path parameters

- `id` integer, required

## Request body

- object
  - `hidden` boolean, required — When true, answers are hidden from typical manager views; when false, answers are shown.
  - `questionIds` integer[], nullable — Optional. When omitted or null, hidden applies to every GTKY answer row for the packet. When a non-empty array of employee personal question ids, only those questions (must belong to this packet) are updated.

## Response `200`

Success — returns the current visibility for each GTKY answer row on the packet.

- object
  - `gtkys` object[], required — GTKY personal-question answer rows with visibility flags.
    - `responseId` integer, required
    - `questionId` integer, required
    - `hidden` boolean, required

## Other responses

- `400` — Bad request — invalid body (e.g. hidden type, questionIds shape, ids not linked to this packet), or visibility change not allowed on or after the employee hire date when a hire date is set
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

---

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