v1

latestOpenAPI 3.1.02026-07-26294215839.4 KB

Onboarding

Public API

Update GTKY answer visibility for a new hire packet

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

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

Path parameters

idinteger required

Request body

hiddenboolean required

When true, answers are hidden from typical manager views; when false, answers are shown.

questionIdsinteger[] 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

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