> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useorgx.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API clients

> Call OrgX REST API v1 from JavaScript or Python with the same create-and-complete workflow.

OrgX uses ordinary HTTPS and JSON. Start with your runtime’s standard HTTP
client; generate a typed client from the [OpenAPI
document](https://useorgx.com/api/v1/openapi.yaml) when your application needs
broader coverage.

> [tab] JavaScript
>
> ```js theme={"dark"}
> 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);
> ```

> [tab] Python
>
> ```python theme={"dark"}
> 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:

```text theme={"dark"}
POST /api/v1/work/{taskId}/complete
```

```json theme={"dark"}
{
  "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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.