FluidGrids Python SDK

Official Python SDK for FluidGrids, the workflow automation platform.

It is a thin shell over burdenoff-sdk-libs, like vibecontrols-sdk: FluidGrids operations live in the shared fluidgrids module (sdk.fluidgrids), and the platform modules are mounted alongside (sdk.auth, sdk.workspaces, sdk.tags, sdk.files, sdk.billing, sdk.notifications, sdk.support, sdk.store, sdk.integrations, …).

Installation

fluidgrids-sdk is not on PyPI yet. Install from source:

pip install -e .        # pulls burdenoff-sdk-libs from PyPI

Requires Python 3.10+.

Quick start

import asyncio
from fluidgrids_sdk import FluidGridsSDK

async def main() -> None:
    async with FluidGridsSDK(access_token=token, refresh_token=refresh) as sdk:
        # Workspace calls need a workspace token as well as the platform token.
        await sdk.auth.issue_workspace_token(workspace_id, organization_id)

        page = await sdk.fluidgrids.workflows.list({"status": "ACTIVE", "limit": 20})
        run = await sdk.fluidgrids.workflows.trigger(
            {"workflow_key": "invoice-sync", "version": "1.0.0", "trigger_node_id": "start",
             "trigger_data": {"amount": 42}}
        )
        done = await sdk.fluidgrids.runs.wait_for_completion(run.run_id, timeout=600)
        logs = await sdk.fluidgrids.runs.logs(run.run_id, min_level="WARN")

asyncio.run(main())

Get tokens with any sdk.auth flow: device code, PKCE, or client credentials for automation.

The FluidGrids module

Responses are snake_case dataclasses. Inputs are snake_case dicts; only their top-level keys are converted to GraphQL names, so JSON values such as definition_json or trigger_data are sent exactly as given.

A credential is an integration connection, created in two steps: create (no secret material), then authenticate_with_api_key / authenticate_with_basic_auth.

Configuration

The workflow service is product-scoped: the gateway works out the product from the request Origin, which httpx does not send by itself. The SDK sets it for the production and alpha gateways; pass product_origin for a custom or local gateway.

Development

python -m venv .venv && .venv/bin/pip install -e ".[dev,test]"
make sanity

tests/test_graphql_documents.py validates every FluidGrids document against the vendored schema/wspace.graphql (see schema/README.md to refresh it). Change FluidGrids behaviour in sdk-libs-python (modules/fluidgrids/) and its Node twin; this repo only picks modules and product defaults.

License

Proprietary — Copyright (c) Algoshred Technologies Private Limited