Read a stored initiative plan proposal
curl --request GET \
--url https://useorgx.com/api/v1/initiatives/proposals/{proposalId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://useorgx.com/api/v1/initiatives/proposals/{proposalId}', 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/{proposalId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, 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"
}
]
},
"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"
},
"context": {
"depth": "full",
"agent_assignment": "auto"
},
"source_evidence": null,
"created_at": "2026-08-19T12:00:00.000Z"
},
"meta": {
"apiVersion": "1",
"workspaceId": "09707fa5-aaae-4493-8a23-827111000f89"
}
}{
"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
}
}Initiatives
Read a stored initiative plan proposal
Retrieve a proposal for review or diff. The returned
proposal_digest is exactly the value a commit must echo. Status is
one of proposed, instantiated (with instantiated_initiative_id), or
expired.
GET
/
initiatives
/
proposals
/
{proposalId}
Read a stored initiative plan proposal
curl --request GET \
--url https://useorgx.com/api/v1/initiatives/proposals/{proposalId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://useorgx.com/api/v1/initiatives/proposals/{proposalId}', 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/{proposalId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, 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"
}
]
},
"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"
},
"context": {
"depth": "full",
"agent_assignment": "auto"
},
"source_evidence": null,
"created_at": "2026-08-19T12:00:00.000Z"
},
"meta": {
"apiVersion": "1",
"workspaceId": "09707fa5-aaae-4493-8a23-827111000f89"
}
}{
"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_...
Path Parameters
Proposal UUID
Query Parameters
Workspace scope; optional when the API key is workspace-bound
