SDKs

Typed clients, generated from the spec.

Five languages from one OpenAPI source — a client that cannot drift from the API. Install it, export your token, and your first call is three lines.

npm

@growomat/client · GA

pip

growomat · alpha

Source

/api/v1/openapi.json · regenerated every release

Token

GROWOMAT_TOKEN · read from the environment by every client

clients auto-retry 429s with the server’s Retry-After · pagination as iterators

install — first call

$ npm install @growomat/client

import { Growomat } from '@growomat/client';

const grow = new Growomat({ token: process.env.GROWOMAT_TOKEN });

// iterate every campaign — pagination handled for you
for await (const c of grow.campaigns.list()) {
  console.log(c.name, c.status);
}
Languages

Five clients, one source of truth.

Each client is generated from the same OpenAPI spec that powers the app, and is tested on every release.

TypeScript

GA
npm install @growomat/client

Full typings, ESM + CJS, streaming report downloads, edge-runtime safe.

Python

Alpha
pip install growomat

Typed models, sync and asyncio clients. The API is stable; the surface is still widening.

Go

Soon
go get …

Generated from the same spec — lands after Python reaches GA.

PHP

Soon
composer require …

Generated from the same spec — track the changelog for the release.

Java

Soon
maven / gradle

Generated from the same spec — track the changelog for the release.

How they’re built

The spec is the product.

The same run that builds the clients regenerates every code sample in the docs — what you copy-paste is exactly what the test suite ran. Additive API changes flow into the clients without a major version bump, matching the /api/v1 versioning policy.

Built in

What every client does for you.

Retries. 429s are retried automatically, honouring the server’s Retry-After.
Pagination. Cursor pages surface as plain iterators — no cursor bookkeeping.
Typed errors. Every error code in the contract is a typed exception you can catch.
Spaces. Pass a Space id once when you construct the client; every call is scoped to it.

Install it. Make one call.

Mint a token in Settings → Developer, export it as GROWOMAT_TOKEN, and the quickstart above runs as-is.