curl --request POST \
--url https://useorgx.com/api/v1/initiatives/proposals \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"title": "Launch the customer API"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({title: 'Launch the customer API'})
};
fetch('https://useorgx.com/api/v1/initiatives/proposals', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://useorgx.com/api/v1/initiatives/proposals"
payload = { "title": "Launch the customer API" }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"proposal_id": "7c1f9a34-5b2e-4d8f-9a01-3e6b7c8d9e0f",
"proposal_digest": "sha256:9b2f1c0d8a7e6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c",
"status": "proposed",
"expires_at": "2026-08-26T12:00:00.000Z",
"plan": {
"initiative": {
"title": "Launch the customer API"
},
"workstreams": [
{
"name": "Strategy",
"domain": "product",
"agent_id": "product-agent",
"agent_name": "Pace",
"confidence": 0.62,
"rationale": "Baseline capability routing.",
"expected_tokens": 8000,
"expected_duration_hours": 5,
"expected_budget_usd": 0.4
}
]
},
"assignment_source": "baseline",
"economics": {
"expected_tokens": 8000,
"expected_hours": 5,
"expected_budget_usd": 0.4,
"human_equivalent_usd": 599.6,
"value_basis": "market_rate_by_task_type_less_spend"
},
"generation_receipt": {
"receipt_id": "1a9f5066-24b3-4d4a-90f0-b0f75fe2fe19",
"provider": "orgx",
"model": "deterministic-baseline",
"tokens_in": 0,
"tokens_out": 0,
"cost_usd": 0
}
},
"meta": {
"apiVersion": "1",
"workspaceId": "09707fa5-aaae-4493-8a23-827111000f89",
"duplicate": true
}
}{
"data": {
"proposal_id": "7c1f9a34-5b2e-4d8f-9a01-3e6b7c8d9e0f",
"proposal_digest": "sha256:9b2f1c0d8a7e6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c",
"status": "proposed",
"expires_at": "2026-08-26T12:00:00.000Z",
"plan": {
"initiative": {
"title": "Launch the customer API"
},
"workstreams": [
{
"name": "Strategy",
"domain": "product",
"agent_id": "product-agent",
"agent_name": "Pace",
"confidence": 0.62,
"rationale": "Baseline capability routing.",
"expected_tokens": 8000,
"expected_duration_hours": 5,
"expected_budget_usd": 0.4
}
]
},
"assignment_source": "baseline",
"economics": {
"expected_tokens": 8000,
"expected_hours": 5,
"expected_budget_usd": 0.4,
"human_equivalent_usd": 599.6,
"value_basis": "market_rate_by_task_type_less_spend"
},
"generation_receipt": {
"receipt_id": "1a9f5066-24b3-4d4a-90f0-b0f75fe2fe19",
"provider": "orgx",
"model": "deterministic-baseline",
"tokens_in": 0,
"tokens_out": 0,
"cost_usd": 0
}
},
"meta": {
"apiVersion": "1",
"workspaceId": "09707fa5-aaae-4493-8a23-827111000f89",
"duplicate": false
}
}{
"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
}
}{
"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
}
}Generate a reviewable initiative plan proposal
Run the planning pipeline synchronously over your title, prompt, and
optional explicit workstreams, and persist an immutable,
digest-addressed proposal — agent assignments with confidence and
rationale, milestone/task expansion, effort and budget estimates, and
the generation receipt. No workstream, milestone, or task rows are
written: review the proposal, then commit it through
POST /initiatives with proposal_id + proposal_digest.
Retrying with the same Idempotency-Key returns the original stored proposal without re-running generation. Rate limited to 6 requests per minute with one concurrent generation per workspace.
curl --request POST \
--url https://useorgx.com/api/v1/initiatives/proposals \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"title": "Launch the customer API"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({title: 'Launch the customer API'})
};
fetch('https://useorgx.com/api/v1/initiatives/proposals', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://useorgx.com/api/v1/initiatives/proposals"
payload = { "title": "Launch the customer API" }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"proposal_id": "7c1f9a34-5b2e-4d8f-9a01-3e6b7c8d9e0f",
"proposal_digest": "sha256:9b2f1c0d8a7e6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c",
"status": "proposed",
"expires_at": "2026-08-26T12:00:00.000Z",
"plan": {
"initiative": {
"title": "Launch the customer API"
},
"workstreams": [
{
"name": "Strategy",
"domain": "product",
"agent_id": "product-agent",
"agent_name": "Pace",
"confidence": 0.62,
"rationale": "Baseline capability routing.",
"expected_tokens": 8000,
"expected_duration_hours": 5,
"expected_budget_usd": 0.4
}
]
},
"assignment_source": "baseline",
"economics": {
"expected_tokens": 8000,
"expected_hours": 5,
"expected_budget_usd": 0.4,
"human_equivalent_usd": 599.6,
"value_basis": "market_rate_by_task_type_less_spend"
},
"generation_receipt": {
"receipt_id": "1a9f5066-24b3-4d4a-90f0-b0f75fe2fe19",
"provider": "orgx",
"model": "deterministic-baseline",
"tokens_in": 0,
"tokens_out": 0,
"cost_usd": 0
}
},
"meta": {
"apiVersion": "1",
"workspaceId": "09707fa5-aaae-4493-8a23-827111000f89",
"duplicate": true
}
}{
"data": {
"proposal_id": "7c1f9a34-5b2e-4d8f-9a01-3e6b7c8d9e0f",
"proposal_digest": "sha256:9b2f1c0d8a7e6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c",
"status": "proposed",
"expires_at": "2026-08-26T12:00:00.000Z",
"plan": {
"initiative": {
"title": "Launch the customer API"
},
"workstreams": [
{
"name": "Strategy",
"domain": "product",
"agent_id": "product-agent",
"agent_name": "Pace",
"confidence": 0.62,
"rationale": "Baseline capability routing.",
"expected_tokens": 8000,
"expected_duration_hours": 5,
"expected_budget_usd": 0.4
}
]
},
"assignment_source": "baseline",
"economics": {
"expected_tokens": 8000,
"expected_hours": 5,
"expected_budget_usd": 0.4,
"human_equivalent_usd": 599.6,
"value_basis": "market_rate_by_task_type_less_spend"
},
"generation_receipt": {
"receipt_id": "1a9f5066-24b3-4d4a-90f0-b0f75fe2fe19",
"provider": "orgx",
"model": "deterministic-baseline",
"tokens_in": 0,
"tokens_out": 0,
"cost_usd": 0
}
},
"meta": {
"apiVersion": "1",
"workspaceId": "09707fa5-aaae-4493-8a23-827111000f89",
"duplicate": false
}
}{
"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
}
}{
"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
OrgX API key, sent as Authorization: Bearer oxk_...
Headers
Workspace-scoped retry key for safe mutation replay.
1 - 200^[A-Za-z0-9][A-Za-z0-9._:/-]{0,199}$Body
1 - 2004000Small-prompt carrier folded into the generation intent
400020Show child attributes
Show child attributes
initiative, workstreams, full When present, generation only fills gaps in your explicit lanes
20Show child attributes
Show child attributes
auto, none Show child attributes
Show child attributes
Show child attributes
Show child attributes
