curl --request POST \
  --url https://useorgx.com/api/v1/discovery-runs/{runId}/propose \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "workspace_id": "98608ef9-3fc8-4e9a-8ae4-5f80e214cfab",
  "process_candidate_id": "721da6a4-20db-43c8-8688-c0740669f001"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    workspace_id: '98608ef9-3fc8-4e9a-8ae4-5f80e214cfab',
    process_candidate_id: '721da6a4-20db-43c8-8688-c0740669f001'
  })
};

fetch('https://useorgx.com/api/v1/discovery-runs/{runId}/propose', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://useorgx.com/api/v1/discovery-runs/{runId}/propose"

payload = {
    "workspace_id": "98608ef9-3fc8-4e9a-8ae4-5f80e214cfab",
    "process_candidate_id": "721da6a4-20db-43c8-8688-c0740669f001"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "process": {
      "schemaVersion": "1.0.0",
      "id": "a5614527-0ce6-43be-8d1d-d012b7394867",
      "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89",
      "name": "Review the launch plan",
      "purpose": "Coordinate a launch review from proposal through verified completion.",
      "valueRecipientRefs": [
        {
          "id": "2d4b7f66-3a2a-4e9d-9ad1-3b2d1b2e4101",
          "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89"
        }
      ],
      "domainRef": {
        "id": "2d4b7f66-3a2a-4e9d-9ad1-3b2d1b2e4101",
        "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89"
      },
      "lifecycleState": "discovered",
      "currentRevisionRef": {
        "id": "2d4b7f66-3a2a-4e9d-9ad1-3b2d1b2e4101",
        "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89"
      },
      "accountableResponsibilityLinkRef": {
        "id": "2d4b7f66-3a2a-4e9d-9ad1-3b2d1b2e4101",
        "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89"
      },
      "provenanceMode": "declared",
      "confidence": 0,
      "tags": [
        "launch-readiness"
      ],
      "createdAt": "2026-08-18T18:30:00.000Z",
      "updatedAt": "2026-08-18T18:30:00.000Z"
    },
    "revision": {
      "schemaVersion": "1.0.0",
      "id": "a5614527-0ce6-43be-8d1d-d012b7394867",
      "processId": "75e02472-b242-4af9-845d-436c040749ed",
      "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89",
      "revisionNumber": 1,
      "contentDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "authoredBy": {
        "type": "human",
        "id": "2d4b7f66-3a2a-4e9d-9ad1-3b2d1b2e4101"
      },
      "stages": [
        {
          "key": "review",
          "name": "Review"
        }
      ]
    },
    "discoveryRunId": "cce395d4-d858-4558-8424-03fdac3f131a",
    "processCandidateId": "c21b2e28-4c49-4364-88e6-63a6c13d8a02",
    "ledger": {
      "eventId": "5e0e63b4-ae40-4cad-8d31-ab19a5622e4c",
      "aggregateVersion": 1,
      "eventHash": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "duplicate": false,
      "payloadDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
    }
  },
  "meta": {}
}

{
  "data": {
    "process": {
      "schemaVersion": "1.0.0",
      "id": "a5614527-0ce6-43be-8d1d-d012b7394867",
      "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89",
      "name": "Review the launch plan",
      "purpose": "Coordinate a launch review from proposal through verified completion.",
      "valueRecipientRefs": [
        {
          "id": "2d4b7f66-3a2a-4e9d-9ad1-3b2d1b2e4101",
          "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89"
        }
      ],
      "domainRef": {
        "id": "2d4b7f66-3a2a-4e9d-9ad1-3b2d1b2e4101",
        "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89"
      },
      "lifecycleState": "discovered",
      "currentRevisionRef": {
        "id": "2d4b7f66-3a2a-4e9d-9ad1-3b2d1b2e4101",
        "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89"
      },
      "accountableResponsibilityLinkRef": {
        "id": "2d4b7f66-3a2a-4e9d-9ad1-3b2d1b2e4101",
        "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89"
      },
      "provenanceMode": "declared",
      "confidence": 0,
      "tags": [
        "launch-readiness"
      ],
      "createdAt": "2026-08-18T18:30:00.000Z",
      "updatedAt": "2026-08-18T18:30:00.000Z"
    },
    "revision": {
      "schemaVersion": "1.0.0",
      "id": "a5614527-0ce6-43be-8d1d-d012b7394867",
      "processId": "75e02472-b242-4af9-845d-436c040749ed",
      "workspaceId": "09707fa5-aaae-4493-8a23-827111000f89",
      "revisionNumber": 1,
      "contentDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "authoredBy": {
        "type": "human",
        "id": "2d4b7f66-3a2a-4e9d-9ad1-3b2d1b2e4101"
      },
      "stages": [
        {
          "key": "review",
          "name": "Review"
        }
      ]
    },
    "discoveryRunId": "cce395d4-d858-4558-8424-03fdac3f131a",
    "processCandidateId": "c21b2e28-4c49-4364-88e6-63a6c13d8a02",
    "ledger": {
      "eventId": "5e0e63b4-ae40-4cad-8d31-ab19a5622e4c",
      "aggregateVersion": 1,
      "eventHash": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "duplicate": false,
      "payloadDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
    }
  },
  "meta": {}
}

{
  "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
  }
}