Decisions - OrgX Docs

Decisions are approval points where humans review agent work before it ships. They connect evidence, artifacts, comments, and final approval state.

Decision review and resolution are MCP-first in Public Preview. REST decision resources are planned for the stable API, but the production-grade approval path today is the hosted MCP API.

Recommended MCP Tools

Operation	Tool
List work needing approval	`orgx_decide`
List pending decisions exactly	`orgx_search(type=decision,status=pending)`
Approve a decision	`orgx_decide`
Reject a decision	`orgx_decide`
Search past decisions	`orgx_search` or `orgx_search`

First Call

orgx_decide

The tool returns pending decisions with enough context for a human or AI client to review the artifact, evidence, risk, and recommended next action.

REST Preview Status

Use these REST resources around decisions today:

GET /api/client/live/initiatives exposes pendingDecisions counts.
POST /api/client/tools/execute can search decision memory with orgx_search.
GET /api/client/artifacts/{artifactId} and GET /api/client/artifacts/by-entity can fetch approved or linked artifacts.

Stable REST decision read/write endpoints will be documented here as they graduate from MCP-first preview to REST Public Preview.

Security Model

Decision writes require explicit authenticated scope. OrgX does not allow anonymous approval, rejection, or artifact shipping. Every sensitive decision action is audit logged.

Initiatives Agents

​Recommended MCP Tools

​First Call

​REST Preview Status

​Security Model

Recommended MCP Tools

First Call

REST Preview Status

Security Model