API clients - OrgX Docs

OrgX uses ordinary HTTPS and JSON. Start with your runtime’s standard HTTP client; generate a typed client from the OpenAPI document when your application needs broader coverage.

JavaScript
Python

const response = await fetch('https://useorgx.com/api/v1/work', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.ORGX_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'launch-plan-review-001',
  },
  body: JSON.stringify({ title: 'Review the launch plan' }),
});
const created = await response.json();
console.log(created.data.taskId, created.data.receiptId);

import json
import os
from urllib.request import Request, urlopen

request = Request(
    "https://useorgx.com/api/v1/work",
    data=json.dumps({"title": "Review the launch plan"}).encode(),
    headers={
        "Authorization": f"Bearer {os.environ['ORGX_API_KEY']}",
        "Content-Type": "application/json",
        "Idempotency-Key": "launch-plan-review-001",
    },
    method="POST",
)
created = json.load(urlopen(request))
print(created["data"]["taskId"], created["data"]["receiptId"])

Complete work

Use the task ID in the URL and send the concurrency values returned by create:

POST /api/v1/work/{taskId}/complete

{
  "expected_updated_at": "2026-08-18T18:30:00.000Z",
  "expected_aggregate_version": 1,
  "summary": "Launch plan reviewed",
  "evidence": { "reviewed_sections": 12, "broken_links": 0 }
}

Where the result appears

Open https://useorgx.com/tasks/{taskId} with the ID returned by create. The same ID remains stable across idempotent retries.

Generate a client

The OpenAPI document includes operation-scoped request and response examples. Use a generator that supports OpenAPI 3.1 and pin the generated code in your normal dependency workflow.