Examples

Every example follows the same shape: install the SDK, configure the handler, register a factory for each model, and expose a single POST endpoint. Each factory carries an input schema (Pydantic in Python, Zod in TypeScript, and so on) so the SDK can describe the model to the dashboard and validate the create payload before invoking your code. There is no SQL introspection and no SQL fallback.

Available examples

All examples live in the SDK repository. Each one ships with a README covering prerequisites, quick start, project structure, and how it works.

LanguageFrameworkSchema libSource
TypeScriptExpressZodexpress
TypeScriptNext.js (App Router)Zodnextjs
TypeScriptHonoZodhono
PythonFastAPIPydanticfastapi
PythonFlaskPydanticflask
PythonDjangoPydanticdjango
ElixirPhoenixEcto schemasphoenix
JavaSpring BootBean Validationspring-boot
RubyRailsdry-validationrails
RustAxumserde + validatoraxum
GoGingo-playground/validatorgin
PHPLaravelSymfony Validatorlaravel

Configuration reference

Every example configures the same handler fields:

FieldDescription
scopeFieldThe column that scopes all models to a tenant (e.g. organizationId). Declared in discover so the dashboard knows how to isolate test data.
sharedSecretShared between your server and Autonoma. Verifies incoming requests via HMAC-SHA256. Generate with openssl rand -hex 32.
signingSecretPrivate to your server. Signs the refs token so teardown can only delete what was created. Generate with openssl rand -hex 32, and make it different from sharedSecret.
factoriesOne factory per model. Each declares an inputSchema / input_model plus a create that calls your real service, and an optional teardown.
authCalled during up with the created user. Returns credentials (cookies, headers, or credentials) so Autonoma can act as the test user.

For what each field does in depth, see Factories & the create payload, Authentication, and Security.

Link copied