Evaluate the deterministic decision engine. Side-effect free: never writes a decision event.

Returns one attention mode — ACT | RECOVER | VALIDATE | VERIFY | CHALLENGE | WAIT | ESCALATE — with the reasons and the inputs it used, plus engine_version and a state_fingerprint. Repeated GETs write nothing, even when the recommendation changes because the underlying state changed. An ACTIVE DENY or REQUIRE_APPROVAL policy takes precedence over every other rule. To adopt or reject a recommendation, POST /decisions.

get/decisions/recommendation

Request

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

Query parameters

idstring

Optional. Narrow the SAME evaluation to one action id: the response then carries only that action's allocation as primary, plus subject_action_id and narrowed: true. Omit it for the workspace-wide recommendation.

actionIdstring

Accepted alias of id (action_id is also accepted).

cursorstring

Accepted for pagination symmetry with other reads; the evaluation is not paginated.

limitinteger

Accepted; the evaluation returns every allocation it computed.

offsetinteger

Accepted; see limit.

Response

Recommendation

object required

Changes

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