---
title: "Update an inbox"
method: PATCH
path: "/inboxes/{id}"
---

# Update an inbox

`PATCH /inboxes/{id}`

## Request

- Base URL: `https://worker.openhelm.ai/v1`
- URL: `https://worker.openhelm.ai/v1/inboxes/{id}`
- Auth: HTTP bearer

`autonomy` governs OUTBOUND: auto sends, notify sends and files a notice, approve_first holds for a human. `inbound_jobs_on` governs INBOUND and is the one people trip over: it defaults to `fresh` (uncorrelated mail only), so REPLIES to mail you sent do not wake a job. Any support or reply-driven workflow wants `all`.

## Path parameters

- `id` string, required

## Request body

- object
  - `autonomy` 'auto' | 'approve_first' | 'notify'
  - `status` 'active' | 'paused'
  - `callback_url` string, nullable
  - `display_name` string
  - `inbound_jobs_on` 'none' | 'fresh' | 'all'
  - `inbound_webhook_on` 'none' | 'correlated' | 'all'
  - `daily_trigger_cap` integer, nullable
  - `labeling_rules` object[]
  - `extraction_schema` object

## Response `200`

OK

---

[API](https://skmtc.dev/openhelm/apis/openhelm-public-api.md) · [All operations](https://skmtc.dev/openhelm/apis/openhelm-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openhelm/apis/openhelm-public-api/revisions/2af88dc2f6a7?raw)