Skip to content

Update Constitution

PUT
/api/v1/settings/constitutions/{role}

Upsert the charter for role from a YAML body.

Client- and server-side validation:

  • Role must be one of the 8 C-suite codes.
  • Body must parse as YAML.
  • core_values must be a non-empty list.
  • risk_appetite_prior must be in [0, 1].
  • communication_style.forbidden_phrases key must be present.

Authorizations

Parameters

Path Parameters

role
required
string

Request Body required

object
yaml
required
string
>= 10 characters <= 50000 characters

Responses

200

Successful Response

A single role charter rendered for the settings UI.

object
communication_style
required
object
key
additional properties
any
core_values
required
Array<string>
decision_heuristics
required
Array<string>
risk_appetite_prior
required
number
role
required
string
version
required
integer
yaml
required
string

422

Validation Error

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