lowcoai-lowcodb

Python client for the lowcodb manager service. Sync and asyncio clients with the same surface, built on httpx. Python 3.10+.

pip install lowcoai-lowcodb

Quick start

from lowcoai.lowcodb import LowcodbClient

with LowcodbClient("<token-or-api-key>", org_id="org_123") as client:
    bases = client.list_bases()
    base = client.create_base({"name": "crm", "baseType": "internal"})

    row = client.create_record(base["schema"], "leads", {"name": "Ada", "status": "open"})
    open_leads = client.list_records(base["schema"], "leads", filter="status='open'", size=50)

asyncio

from lowcoai.lowcodb import AsyncLowcodbClient

async with AsyncLowcodbClient("<token-or-api-key>", org_id="org_123") as client:
    bases = await client.list_bases()

AsyncLowcodbClient has the same methods as LowcodbClient; each one is a coroutine. Close it with await client.aclose() if you don't use async with.

Options

client.set_org_id(...) and client.set_header(key, value) change headers for later requests; pass None to remove.

Data shapes

Request and response bodies are plain dicts typed as TypedDicts (Base, Table, Column, DBFunction, …) whose keys match the JSON on the wire (camelCase). A value returned by one call can be sent back as the body of another. Rows are dict[str, Any] (LowcodbRecord).

List methods take keyword-only page_no, size, filter and sort.

Surface

Transactions

client.execute_transaction(
    "app_crm",
    [
        {"type": "create", "table": "leads", "record": {"name": "Ada"}},
        {"type": "update", "table": "accounts", "id": "acc_1", "record": {"leadCount": 4}},
    ],
)

All operations succeed or none apply (internal bases only).

DB functions

fn = client.create_function(
    {
        "baseId": base["id"],
        "name": "Score lead",
        "functionKey": "score-lead",
        "body": "return { score: ctx.request.body.value * 2 };",
    }
)

result = client.execute_function(fn["id"], {"value": 21})  # console run: result, logs, error
value = client.invoke_function("app_crm", "score-lead", {"value": 21})  # data-plane call
value = client.invoke_function("app_crm", "score-lead", method="GET")

Errors

Every non-2xx response raises LowcodbError with status_code, message, code and the raw body:

from lowcoai.lowcodb import LowcodbError

try:
    client.invoke_function("app_crm", "score-lead", {})
except LowcodbError as err:
    print(err.status_code, err.message, err.code)

When the manager answers with an opaque platform code ("AAS-00105") as the message, message carries the human-readable error.details instead; the code is still in body. Network failures and timeouts surface as httpx exceptions.