Reconcile one domain controller in shadow mode
curl --request POST \
--url https://useorgx.com/api/v1/controllers/{domain}/reconcile \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"workspace_id": "11111111-1111-4111-8111-111111111111",
"idempotency_key": "growth-cadence-canary-2026-08-26",
"mode": "shadow",
"protocol_version": "orgx.controller.v1"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
workspace_id: '11111111-1111-4111-8111-111111111111',
idempotency_key: 'growth-cadence-canary-2026-08-26',
mode: 'shadow',
protocol_version: 'orgx.controller.v1'
})
};
fetch('https://useorgx.com/api/v1/controllers/{domain}/reconcile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://useorgx.com/api/v1/controllers/{domain}/reconcile"
payload = {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"idempotency_key": "growth-cadence-canary-2026-08-26",
"mode": "shadow",
"protocol_version": "orgx.controller.v1"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"controller_id": "domain.growth",
"domain": "growth",
"spec_revision": "controller_spec_revision:09a53f2c0987b63cf07557d50b378e8ad2473591a943ceb6f6912e0e7c679015",
"run_id": "controller_run:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"last_run_id": "controller_run:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"status": "degraded",
"result": "noop",
"last_result": "noop",
"last_signal_id": null,
"last_signal_state": null,
"last_error_code": null,
"event_ids": [
"33333333-3333-4333-8333-333333333333",
"44444444-4444-4444-8444-444444444444"
],
"projection_cursor": "2",
"decision_id": null,
"decision_event_id": null,
"receipt_id": null,
"last_receipt_id": null,
"duplicate": false,
"protocol_version": "orgx.controller.v1",
"mode": "shadow",
"proposal": null,
"learning_proposal": null,
"noop_reason": "insufficient_evidence",
"source_health": {
"state": "insufficient_evidence",
"observedAt": "2026-08-26T08:10:00.000Z",
"freshnessWatermark": null,
"sourceCursor": null,
"recordCount": 0,
"limitations": [
"No completed work met the active evidence profile."
]
},
"limitations": [
"Shadow proposals require human review and have no authority effect.",
"Receipt fields remain null until canonical execution admission exists."
]
},
"meta": {
"apiVersion": "1",
"workspaceId": "11111111-1111-4111-8111-111111111111"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}Controllers
Reconcile one domain controller in shadow mode
Produces a typed shadow proposal candidate or no-op. A proposal is atomically admitted as a pending human Decision with canonical decision.proposed evidence and a neutral reconciliation Receipt. It grants no execution or policy authority.
POST
/
controllers
/
{domain}
/
reconcile
Reconcile one domain controller in shadow mode
curl --request POST \
--url https://useorgx.com/api/v1/controllers/{domain}/reconcile \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"workspace_id": "11111111-1111-4111-8111-111111111111",
"idempotency_key": "growth-cadence-canary-2026-08-26",
"mode": "shadow",
"protocol_version": "orgx.controller.v1"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
workspace_id: '11111111-1111-4111-8111-111111111111',
idempotency_key: 'growth-cadence-canary-2026-08-26',
mode: 'shadow',
protocol_version: 'orgx.controller.v1'
})
};
fetch('https://useorgx.com/api/v1/controllers/{domain}/reconcile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://useorgx.com/api/v1/controllers/{domain}/reconcile"
payload = {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"idempotency_key": "growth-cadence-canary-2026-08-26",
"mode": "shadow",
"protocol_version": "orgx.controller.v1"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"controller_id": "domain.growth",
"domain": "growth",
"spec_revision": "controller_spec_revision:09a53f2c0987b63cf07557d50b378e8ad2473591a943ceb6f6912e0e7c679015",
"run_id": "controller_run:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"last_run_id": "controller_run:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"status": "degraded",
"result": "noop",
"last_result": "noop",
"last_signal_id": null,
"last_signal_state": null,
"last_error_code": null,
"event_ids": [
"33333333-3333-4333-8333-333333333333",
"44444444-4444-4444-8444-444444444444"
],
"projection_cursor": "2",
"decision_id": null,
"decision_event_id": null,
"receipt_id": null,
"last_receipt_id": null,
"duplicate": false,
"protocol_version": "orgx.controller.v1",
"mode": "shadow",
"proposal": null,
"learning_proposal": null,
"noop_reason": "insufficient_evidence",
"source_health": {
"state": "insufficient_evidence",
"observedAt": "2026-08-26T08:10:00.000Z",
"freshnessWatermark": null,
"sourceCursor": null,
"recordCount": 0,
"limitations": [
"No completed work met the active evidence profile."
]
},
"limitations": [
"Shadow proposals require human review and have no authority effect.",
"Receipt fields remain null until canonical execution admission exists."
]
},
"meta": {
"apiVersion": "1",
"workspaceId": "11111111-1111-4111-8111-111111111111"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}Authorizations
bearerAuthcookieAuth
OrgX API key, sent as Authorization: Bearer oxk_...
Headers
Accepted for forward compatibility. Replay safety for this operation comes from its own state checks, described on the operation.
Required string length:
1 - 200Pattern:
^[A-Za-z0-9][A-Za-z0-9._:/-]{0,199}$Path Parameters
Available options:
product, engineering, growth, sales, design, operations Body
application/json
Required string length:
1 - 200Allowed value:
"shadow"Allowed value:
"orgx.controller.v1"Pattern:
^controller_spec_revision:[a-f0-9]{64}$Required string length:
1 - 512Required range:
1 <= x <= 604800