update_organization
Set or reset an organization's target IEC 62443-4-1 maturity level and NIST CSF tier for secure development and cybersecurity risk management.
Instructions
Set per-organization level grades for IEC 62443-4-1 and NIST CSF.
Admin-only: the backend requires the caller to be an admin in the organization (or a superadmin). Non-admins will get a 403; do not invoke this tool unless you've verified admin role for the target org.
target_ml is the IEC 62443-4-1 Maturity Level the organization
targets for its secure-development program (1-5). csf_tier is
the NIST CSF Tier the organization targets for its cybersecurity
risk-management posture (1-4).
Because None on the wire is indistinguishable from "field
omitted", pass clear_target_ml=True or clear_csf_tier=True
to explicitly reset a value to NULL. Omitting both the value and
its clear_* flag leaves the existing server-side value
untouched.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| org_id | Yes | Organization ID. | |
| csf_tier | No | NIST CSF Tier (1-4), or ``None`` to leave unchanged. | |
| target_ml | No | IEC 62443-4-1 Maturity Level (1-5), or ``None`` to leave unchanged. | |
| clear_csf_tier | No | Explicitly reset ``csf_tier`` to NULL. | |
| server_version | Yes | ||
| clear_target_ml | No | Explicitly reset ``target_ml`` to NULL. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||