Propose a business policy. An ordinary agent can never activate a safety gate.

Capability: policies:propose. A DENY or REQUIRE_APPROVAL policy submitted by an ordinary read+write credential is stored as PROPOSED and is NOT enforced; it becomes ACTIVE only after a human workspace owner/admin confirms it in Forbiz, or when the credential holds the delegated policies:manage capability. ADVISORY policies may be created directly. Passing a confirmedBy name is provenance, not authority: it never activates anything.

post/policies

Request

  • Base URL: https://forbiz.io/api/public/agent
  • URL: https://forbiz.io/api/public/agent/policies
  • Auth: HTTP bearer

Request body

policyKeystring
effect'DENY' | 'REQUIRE_APPROVAL' | 'ALLOW' | 'ADVISORY'
appliesTostring
humanDescriptionstring
statedBystring
confirmedBystring
effectiveFromstring
expiresAtstring

Response

Policy stored (check status: PROPOSED means not enforced)

object required

Changes

No recorded changes to this operation across all 1 revision of this API.