Skip to content

Update Tenant Constitution

PUT
/api/v1/settings/constitutions/tenant

Upsert the tenant-wide Standing Operating Charter.

Transaction ownership: :class:ConstitutionService.upsert only validates and flushes — THIS handler commits, rereads the authoritative row, and only then publishes MessageType.CONSTITUTION_UPDATED. A rolled-back write therefore can never return 200 or emit the event: service ValueError maps to 422, and any DB error propagates to a 500.

The CONSTITUTION_UPDATED event is audit/analytics-only (BigQuery writer / audit-logger sinks); no behavioral consumer exists, so a publish failure is logged and never breaks the response.

Authorizations

Request Body required

Owner-supplied values for the five charter dimensions.

object
brand_voice_strictness
required
string
Allowed values: strict flexible creative
communication_autonomy
required
string
Allowed values: autonomous review-first approval-required
competitor_sensitivity
required
string
Allowed values: aggressive neutral defensive
financial_auth_limit
required
number
risk_tolerance
required
string
Allowed values: conservative moderate aggressive

Responses

200

Successful Response

The tenant-wide Standing Operating Charter (one row per tenant).

object
brand_voice_strictness
required
string
communication_autonomy
required
string
competitor_sensitivity
required
string
configured
required
boolean
financial_auth_limit
required
number
risk_tolerance
required
string
updated_at
required
Any of:
string format: date-time

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string