tumbuh.ai
tumbuh.ai Public API

Get the OpenAPI specification

GET
https://<domain-anda>
/api/v1/public/openapi.json

The complete OpenAPI 3.1 description of this API, generated from the live routes.

Returns the OpenAPI 3.1 document for every endpoint: paths, request shapes, the scope each one requires, its cost tier, its MCP tool name and an example. Use it to generate a client or to check a request shape before sending it. Answers for any valid key. Read-only.

Get the OpenAPI specification › Responses

The API key is missing, malformed, expired, or its owner is inactive.

success
​required
​object · required

Get the agent guide

GET
https://<domain-anda>
/api/v1/public/agent-guide.md

A markdown manual of this API, narrowed by default to what your key may call.

Returns a compact markdown document written to be pasted straight into an AI agent context: how to authenticate, the capabilities this key's scopes admit, the arguments each one takes, what each failure means and how to recover from it, the rate limits, and which actions need human confirmation. Narrowed to your own scopes unless you ask for scope=all. Call it once at startup instead of guessing paths. Read-only.

Get the agent guide › query Parameters

scope
​string · enum

'granted' (the default) returns only what this key may call; 'all' returns the complete surface including capabilities this key would be refused.

'granted' (the default) returns only what this key may call; 'all' returns the complete surface including capabilities this key would be refused.

Enum values:
granted
all

Get the agent guide › Responses

The API key is missing, malformed, expired, or its owner is inactive.

success
​required
​object · required

Test the credential

GET
https://<domain-anda>
/api/v1/public/health

Confirm the API key is valid and report which workspace it belongs to.

Answers for any valid key regardless of its scopes, so it is the way to check a credential before doing anything else. Returns the authenticated user id and the server time. Read-only.

Test the credential › Responses

The API key is missing, malformed, expired, or its owner is inactive.

success
​required
​object · required

Describe the API

GET
https://<domain-anda>
/api/v1/public/catalog

List every Public API endpoint with its scope, description and example.

Returns the machine-readable catalogue of this API: for each endpoint its method, path, required scope, what it does, when to use it, its side effect and a request example. Call it once at startup to discover the surface instead of guessing paths. Read-only.

Describe the API › Responses

The API key is missing, malformed, expired, or its owner is inactive.

success
​required
​object · required