> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useorgx.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Decisions

> Review and resolve OrgX decisions through MCP, with REST preview status.

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

<Info>
  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.
</Info>

## 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

```text theme={"dark"}
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`](/docs/api/rest/initiatives) exposes `pendingDecisions` counts.
* [`POST /api/client/tools/execute`](/docs/api/rest/memory) can search decision memory with `orgx_search`.
* [`GET /api/client/artifacts/{artifactId}`](/docs/api/rest/artifacts) and [`GET /api/client/artifacts/by-entity`](/docs/api/rest/artifacts) 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.