Python SDK

pip install lithora

import os
from lithora import Lithora

client = Lithora(token=os.environ["LITHORA_TOKEN"])

print(client.auth.me()["email"])

team = client.teams.list()[0]
tasks = client.tasks.list(project_id="8f1c0c2e-4a2d-4f5b-9c31-6b2a7e0d4411")
print(f"{len(tasks)} tasks in {team['name']}")

from lithora import Lithora

client = Lithora(
    base_url="https://api.lithora.app",   # default; use http://localhost:8000 for local dev
    token=os.environ["LITHORA_TOKEN"],   # a lth_pat_… token, or a login JWT
    timeout=30,                          # seconds, per request
)

from lithora import Lithora, AuthChallengeError

client = Lithora()
try:
    user = client.login("you@example.com", password)
except AuthChallengeError as exc:
    if exc.requires_2fa:
        ...   # prompt for the authenticator code
    elif exc.requires_login_otp:
        ...   # prompt for the emailed one-time code

# Create
task = client.tasks.create(
    "Retry failed Dodo webhooks",
    project_id,
    description="Add a dead-letter queue with exponential backoff.",
    priority="high",
    due_date="2026-08-15",
    tags=["billing", "reliability"],
)
task_id = task["task_id"]

# Read
client.tasks.list(project_id)     # every task in a project (subtasks nested)
client.tasks.my()                 # assigned to you
client.tasks.get(task_id)

# Update — these return {"message": ...}, not the task. Re-read if you need state.
client.tasks.set_status(task_id, "in_progress")
client.tasks.update(task_id, priority="urgent", assigned_to=user_id)

# Soft delete — moves to Trash, restorable
client.tasks.delete(task_id)

# Typed edges between anything: task, project, file, note, whiteboard, doc
client.work_items.create_relation(source_id, target_id, "blocking")
client.work_items.relations(item_id)
client.work_items.children(item_id)

# Analytics and live GitHub state
client.work_items.cycle_time(team_id=team_id)
client.work_items.pr_status(task_id)
client.work_items.graph(team_id=team_id, limit=200)

session = client.ai.create_session(title="Nightly triage")
sid = session["session_id"]

# Give the agent context. It sees ONLY what you link.
client.ai.link_item(sid, "project", project_id)

reply = client.ai.chat(sid, "Which billing tasks are blocked, and why?")

if reply.get("requires_confirmation"):
    plan = reply["action_plan"]
    print(plan["summary"])                       # show a human the plan
    if approved_by_a_human(plan):                # your call, your policy
        client.ai.confirm_agent_action(sid, plan["action_id"], confirmed=True)
    else:
        client.ai.confirm_agent_action(sid, plan["action_id"], confirmed=False)
else:
    print(reply["response"])

for plan in client.ai.list_pending_actions().get("pending", []):
    print(plan["action_id"], plan.get("summary"))

from lithora import ApiError, AuthError, LithoraError, ServerError

try:
    client.tasks.create("Ship it", project_id)
except AuthError:
    ...                       # 401 — token missing, expired or revoked
except ServerError as exc:
    ...                       # 5xx — retry with backoff
except ApiError as exc:
    if exc.status == 403:
        ...                   # missing scope, not a member, or a guest seat
    elif exc.status == 422:
        print(exc.detail)     # {"errors": [{"field", "message", "type"}]}
    else:
        raise
except LithoraError:
    ...                       # catch-all for anything this SDK raises