---
title: "Update Document Settings"
method: PUT
path: "/company-document-settings"
tags: ["company-document-settings"]
---

# Update Document Settings

`PUT /company-document-settings`

Replace the company's document-wide policy with the body.

Applies to submissions from here on, in both directions. Turning the review
gate on does not reach back and reopen requests already accepted, and turning
it off leaves the ones already waiting for review where they are — those are
still a sign-off or a send-back away.

## Request body

- CompanyDocumentSettingsUpdate — Request body for the company's document-wide policy. The whole policy, not one named switch: the settings page sends the state it wants, so a second switch is a field here rather than another endpoint.
  - `require_submission_review` boolean, required

## Response `200`

Successful Response

- CompanyDocumentSettingsResponse — The company's effective document-wide policy. Always answers with a full policy, filling in the defaults for a company that has never saved one, so the client never has a null state to interpret.
  - `require_submission_review` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/kobaltlabs/apis/fastapi.md) · [All operations](https://skmtc.dev/kobaltlabs/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kobaltlabs/fastapi/revisions/3ff4c0bd276b/schema)