fossa_update_org_settings
Update a FOSSA organization's settings by replacing a section or propagating its defaults to every project.
Instructions
Write one section of a FOSSA organization's settings, or push a section's organization defaults down onto every existing project.
WRITES TO FOSSA. Requires FOSSA_ORG_ID, FOSSA_ALLOW_WRITES=true and FOSSA_ALLOW_DESTRUCTIVE=true. Both actions destroy state, for different reasons, and some sections require more still; the tier is decided per call:
action="replace" requires FOSSA_ALLOW_DESTRUCTIVE=true. The PUT replaces the whole section rather than merging into it, so a body that omits a key erases it, and FOSSA offers no undo.
action="propagate" requires FOSSA_ALLOW_DESTRUCTIVE=true. It overwrites the named setting on every project in the organization, so its target set is unbounded regardless of the HTTP verb.
section="authentication" also requires FOSSA_ALLOW_ADMIN=true, as does section="general" when
valuescarriesdefaultRoleIdordisableNonCustomTeamUserRoles.
action="replace" (the default) sends the section's PUT. It REPLACES the
section rather than merging, so pass the whole section, not just the key
being changed; re-read it with fossa_org_settings first. values is the
body, keyed by FOSSA's own field names, and unknown keys are rejected before
any request is made. Two sections take a bare JSON array instead and use
items: "languages-pod" (a list of source URLs) and
"integrations-custom-license-scans" (objects with name, matchCriteria,
and optionally id).
action="propagate" sends the section's PATCH and takes fields, the
organization defaults to push out. Only the ten "projects-*" sections
support it, and each accepts its own field list.
One writable section is not readable: "sbom-report-defaults" sets the author and supplier stamped into generated SBOMs. To replace the organization's SAML single sign-on configuration, use fossa_update_saml_settings — it is not a section here.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | No | ||
| action | No | replace | |
| fields | No | ||
| values | No | ||
| section | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||