---
title: "Update Filing Controls"
method: PUT
path: "/automations/filing-controls"
tags: ["Automations"]
---

# Update Filing Controls

`PUT /automations/filing-controls`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/automations/filing-controls`
- Auth: none declared

Flip a source's auto-file mode (the customer-facing inverse of the
developer's dry-run flag).

Enforced per source, not per request: each toggle requires the developer
to have both enabled the source and exposed its toggle, so a customer can
never reach a knob they weren't handed — including via the raw API.
Developers may flip either regardless of exposure (same knob as the
developer panel).

## Request body

- UpdateFilingControlsRequest: Customer-editable subset: only the auto-file toggles, and only for sources the developer has exposed. Omitted fields are left unchanged.
  - `auto_file_granola` boolean, nullable
  - `auto_file_ringcentral` boolean, nullable

## Response `200`

Successful Response

- FilingControlsResponse
  - `granola` FilingSourceControl, required: One source's auto-file state as the customer sees it. ``auto_file`` is the customer-facing inverse of the developer's dry-run flag; "dry run" never appears in customer-facing language.
    - `source_enabled` boolean, required
    - `toggle_exposed` boolean, required
    - `auto_file` boolean, required
  - `ringcentral` FilingSourceControl, required: One source's auto-file state as the customer sees it. ``auto_file`` is the customer-facing inverse of the developer's dry-run flag; "dry run" never appears in customer-facing language.
    - `source_enabled` boolean, required
    - `toggle_exposed` boolean, required
    - `auto_file` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/openintake/apis/openintake-api.md) - [All operations](https://skmtc.dev/openintake/apis/openintake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openintake/apis/openintake-api/revisions/de90a8dcbc07?raw)