Skip to main content
POST
Raise a decision

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string
required

Workspace-scoped retry key for safe mutation replay.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,199}$

Body

application/json
workspace_id
string<uuid>
required
title
string
required
Required string length: 1 - 500
description
string
Maximum string length: 8000
shape
enum<string>
default:generic
Available options:
generic,
artifact_review,
icp_confirm,
budget_approval,
handoff_route,
plan_adjust,
task_restart,
escalation,
option_select,
option_multiselect
shape_context
object
urgency
enum<string>
default:standard
Available options:
deferred,
standard,
urgent,
critical
blocks_task
boolean
task_id
string<uuid>
initiative_id
string<uuid>

Response

The original decision returned for an idempotent replay

decision
object
required

A decision request awaiting or carrying a human ruling. Additional lifecycle fields (resolution, priority, due dates, occurrence tracking) appear as the decision progresses.