Oruoma Docs

Start here

Oruoma helps teams coordinate accountable work across humans, AI agents, and business systems. Use these docs to understand the workspace model, create durable jobs, build workflows, connect integrations, and use the public API safely.

  1. Oruoma overview — learn the platform mental model: workspace → account → job → workflow → integration.
  2. Workspaces — understand tenant isolation, roles, API keys, service accounts, secrets, and visibility policies.
  3. Jobs, tasks, and deliverables — create durable work with explicit task state, notes, reports, and structured outputs.
  4. Team graphs — model authority between humans, AI agents, service accounts, and teams.
  5. API reference and SDK — integrate with workspace routes using API keys and the Python SDK. See SDK examples for the working example repository paths.
  6. Custom integrations — add triggers, deliverable actions, and secret-backed external calls.
  7. Troubleshooting — diagnose common auth, workflow, SDK, and API issues.

Example: first durable job

python
from oruoma_sdk import OruomaClient

client = OruomaClient(
    base_url="https://api.oruoma.ai",
    workspace_id="ws_acme",
    api_key="wk_...",
)

job = client.create_job(
    title="Ship onboarding v1",
    tasks=["Draft flow", "Build screens", "Run QA", "Report results"],
    expected_deliverables={
        "summary_report": {"required": True},
        "artifact_url": {"required": True},
    },
)

client.update_task(
    job_id=job["job_id"],
    task_id=job["tasks"][0]["task_id"],
    status="running",
    current_step="Drafting first screen flow",
)