Skip to content
Skip to Content
Docs
ApiOrg

Update Org Settings

Updates the calling member's organization settings. Only the fields supplied are changed. Requires an organization administrator.

PATCH
/org/settings

Request Body

application/json
  1. body

Partial update of the caller's own organization settings.

Carries no organization identifier, deliberately. The organization is taken from the authenticated request state, so there is no id for a caller to tamper with, no ownership check to author, and no way to address another organization's settings. extra="forbid" makes that structural rather than conventional: a body that supplies org_id is rejected outright instead of having the field quietly ignored.

Every field is optional; a field left unset is left as it is.

metered_usage_enabled?|

Whether the organization accepts charges for usage beyond its plan's included monthly allowance. When false, requests that would be charged are refused; requests within the included allowance are unaffected.

label_findings_policy?|

What a label export does when the label has findings nobody has addressed: 'acknowledge' asks the caller to acknowledge them and then exports; 'block' refuses the export while they stand.

Response Body

Successful Response

application/json
  1. response

The organization's settings after the change.

The settings object bare, with no envelope — matching the only other org route, POST /org/search-token, whose SearchTokenResponse is likewise returned unwrapped. It carries the full current settings rather than only what changed, so a client can render its state from the response without a follow-up read.

metered_usage_enabled*Metered Usage Enabled

Whether the organization accepts charges for usage beyond its plan's included monthly allowance.

label_findings_policy*LabelFindingsPolicy

What a label export does when the label has findings nobody has addressed: 'acknowledge' or 'block'.

Value in"acknowledge""block"
Example Request
curl -X PATCH 'https://api.bettermenu.live/org/settings' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "metered_usage_enabled": true,  "label_findings_policy": "acknowledge"}

Recipe in, FDA-format Nutrition Facts out, with every version kept.

Start freeNo card needed.