Read one decision

Poll a single decision by id. This is the read an automated caller waits on after raising a decision: it reports status, the resolution fields once a human has ruled, the blocking ids the decision is holding up, and the current attention request.

The workspace comes from the decision row rather than from a parameter, so a caller that knows only the decision id can still reach it. Ids outside the caller’s workspaces, ids outside a workspace-bound key’s binding, and ids that were never issued share one not-found response.

GET /decisions/{id}

Read one decision

cURL

curl --request GET \
  --url https://useorgx.com/api/v1/decisions/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "data": {
    "id": "8cf6f6a4-9a3f-4a52-8d0e-6a4c2b1f9e37",
    "workspace_id": "5be1076d-8fd0-4c0f-847f-fd67fdb935e8",
    "title": "Approve the pricing page rewrite",
    "summary": "Two options, both reversible.",
    "shape": "option_select",
    "urgency": "urgent",
    "status": "pending",
    "resolution": null,
    "resolved_at": null,
    "is_resolved": false,
    "blocks_task": true,
    "blocking": {
      "run_id": "9c7b1d68-2c5c-4d6b-9a8e-5c4f2c0c5b4d",
      "initiative_id": "4b014796-2f1e-4a1d-9c3b-7e5a2d6f8c10",
      "workstream_id": "1f2e3d4c-5b6a-4798-8a9b-0c1d2e3f4a5b"
    },
    "attention": {
      "protocol": "orgx.attention.v1",
      "kind": "approval",
      "impact_if_delayed": "The rewrite blocks the launch checklist.",
      "recommended_option_id": "ship",
      "request_count": 2,
      "continuation": {
        "strategy": "resume_session",
        "state": "waiting"
      }
    },
    "poll_url": "/api/v1/decisions/8cf6f6a4-9a3f-4a52-8d0e-6a4c2b1f9e37",
    "resolve_url": "https://useorgx.com/decisions/8cf6f6a4-9a3f-4a52-8d0e-6a4c2b1f9e37",
    "created_at": "2026-08-19T15:04:00.000Z",
    "updated_at": "2026-08-19T15:06:00.000Z"
  },
  "meta": {
    "apiVersion": "1",
    "workspaceId": "5be1076d-8fd0-4c0f-847f-fd67fdb935e8"
  }
}

Authorizations

bearerAuthcookieAuth

Authorization · string · header · required

OrgX API key, sent as Authorization: Bearer oxk_...

Path Parameters

id · string<uuid> · required

Decision id, as returned by POST /decisions.

Response

200

application/json

The decision, its blocking scope, and its attention state

data · object · required

Show child attributes

meta · object · required

Show child attributes