API quickstart

Create work, see it in Mission Control, and keep the receipt returned by the same request.

1. Create an API key

export ORGX_API_KEY='oxk_...'

Keep API keys in server-side secrets. Never put them in browser code, logs, screenshots, or public repositories.

2. Create work

title is the only required body field. OrgX places the work in the workspace Inbox and creates the supporting hierarchy when it is first needed.

curl -i https://useorgx.com/api/v1/work \
  -X POST \
  -H "Authorization: Bearer $ORGX_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: launch-plan-review-001' \
  -d '{"title":"Review the launch plan"}'

The first request returns 201 Created:

{
  "data": {
    "taskId": "7fbb727d-17c4-4bc7-9fc7-60eb15e9314d",
    "receiptId": "7ab98058-f221-49cc-8aa4-d3d8040249b8",
    "aggregateVersion": 1,
    "duplicate": false,
    "task": {
      "id": "7fbb727d-17c4-4bc7-9fc7-60eb15e9314d",
      "title": "Review the launch plan",
      "status": "todo",
      "updated_at": "2026-08-18T18:30:00.000Z"
    },
    "receipt": {
      "id": "7ab98058-f221-49cc-8aa4-d3d8040249b8",
      "status": "completed",
      "summary": "Review the launch plan"
    }
  },
  "meta": {
    "apiVersion": "1",
    "workspaceId": "5be1076d-8fd0-4c0f-847f-fd67fdb935e8",
    "duplicate": false
  }
}

3. See the result

Open Mission Control, or open the task directly with the returned ID:

https://useorgx.com/tasks/7fbb727d-17c4-4bc7-9fc7-60eb15e9314d

The task page shows the title, current state, hierarchy, and linked evidence available to your workspace.

4. Complete it with evidence

Fetch the work item immediately before completing it. This gives you a signed version_token that preserves timestamp precision and prevents a stale client from overwriting newer work.

curl https://useorgx.com/api/v1/work/7fbb727d-17c4-4bc7-9fc7-60eb15e9314d \
  -H "Authorization: Bearer $ORGX_API_KEY"

Copy data.concurrency.version_token into ORGX_VERSION_TOKEN.

curl https://useorgx.com/api/v1/work/7fbb727d-17c4-4bc7-9fc7-60eb15e9314d/complete \
  -X POST \
  -H "Authorization: Bearer $ORGX_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: launch-plan-review-complete-001' \
  -d '{
    "version_token":"'$ORGX_VERSION_TOKEN'",
    "summary":"Launch plan reviewed",
    "evidence":{"reviewed_sections":12,"broken_links":0}
  }'

The response returns the completed task and a new receipt. Refresh the task page to see the completion and its evidence.

Next useful step

Organize work

Create an initiative when the Inbox is no longer enough.

Use an SDK

Use the same flow from TypeScript or Python.

Read events

Keep another system synchronized with accepted state changes.

Getting Started

Connect Your Tools

Agent Ops

Platform

Build with the API

REST API v1 Reference

Entity Reference

Content Studio API

MCP and Plugins

Resources

1. Create an API key

2. Create work

3. See the result

4. Complete it with evidence

Next useful step

Organize work

Use an SDK

Read events

​1. Create an API key

​2. Create work

​3. See the result

​4. Complete it with evidence

​Next useful step

Organize work

Use an SDK

Read events

1. Create an API key

2. Create work

3. See the result

4. Complete it with evidence

Next useful step