---
title: "Set/clear the org's HITL approval-UX lines"
method: PUT
path: "/v1/hitl/approval-messages"
tags: ["hitl"]
---

# Set/clear the org's HITL approval-UX lines

`PUT /v1/hitl/approval-messages`

## Request body

- ApprovalMessagesUpdate — Set or clear the org's two HITL approval-UX lines (full-replace, PUT semantics). Both fields are REQUIRED but nullable, so a full-replace can't silently wipe a line by omission: a non-blank string SETS that line; ``null`` (or blank) CLEARS it back to the code default; an OMITTED field is a 422 (send the complete desired state, both keys present).
  - `holding_line` string, nullable, required
  - `waiting_reply` string, nullable, required

## Response `200`

Successful Response

- ApprovalMessagesResponse — The org's two HITL approval-UX lines, RESOLVED (org value or code default). Both are always concrete strings: when the org hasn't configured a line, the resolved code default is surfaced so the UI shows exactly what an end-user will see. To revert a line to its default, PUT ``null`` for that field.
  - `holding_line` string, required
  - `waiting_reply` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/versions/888bdd5c076e/schema)