SDK namespaces

Both SDKs expose the same product namespaces. TypeScript uses camelCase; Python uses snake_case. Full HTTP schemas: API reference. Packages: @flowra/sdk, flowra-sdk. Source: github.com/flowradev/sdk. Every method with TS + Python examples: SDK method examples. Tutorials: TypeScript · Python. Escape hatches: TypeScript flowra.raw.* · Python flowra.request(method, path, ...). Copy tool slugs from tools.list. Catalog actions are typically UPPER_SNAKE.

Root

TypeScript	Python	Example
`getProfile()`	`get_profile()`	Who am I for this API key
`asUser(username)`	`as_user(username)`	Scoped client for one end user

const alice = flowra.asUser('customer_alice');
await alice.getProfile(); // still project key; requests carry x-username

alice = flowra.as_user("customer_alice")

tools

list, get, create, update, remove, setActive / set_active, execute, executionLogs / execution_logs

await flowra.tools.execute('GMAIL_SEND_EMAIL', { arguments: { /* ... */ } });

flowra.tools.execute("GMAIL_SEND_EMAIL", {"arguments": {}})

toolkits

list, listWithTools / list_with_tools, get, create, update, remove, setActive / set_active, messagingChannels / messaging_channels, listCategories / list_categories

skills

list, get, create, update, remove, addToLibrary / add_to_library, catalogBrowse / catalog_browse, importGithub / import_github, registryInstall / registry_install, registrySync / registry_sync, registryList / registry_list, registrySearch / registry_search

workflows

list, get, create, update, remove, setActive / set_active, run, status, resume, executions, execution, statistics, executionsFor / executions_for, addConnection / add_connection, changeConnection / change_connection, setAuthConfig / set_auth_config, clearAuthConfig / clear_auth_config, clearConnection / clear_connection

const run = await flowra.workflows.run(id, { input: { message: 'hi' } });
await flowra.workflows.status(run.threadId);

run = flowra.workflows.run(id, {"input": {"message": "hi"}})
flowra.workflows.status(run["threadId"])

connections

list, listGrouped / list_grouped, create, createLink / create_link, update, remove

authConfigs / auth_configs

list, get, create, remove

users

list, create, getByUsername / get_by_username, toggleActive / toggle_active, refreshAvatar / refresh_avatar

triggers

list, upsert, remove, setStatus / set_status, invocationLogs / invocation_logs, replayWebhook / replay_webhook

chat

createThread / create_thread, getThread / get_thread, updateThread / update_thread, deleteThread / delete_thread, searchThreads / search_threads, history, state, stream, listRuns / list_runs, cancelRun / cancel_run, generateTitle / generate_title, sendOperatorReply / send_operator_reply, setReplyMode / set_reply_mode, joinStream / join_stream Deep dive: Chat streaming.

files

list, upload, remove, download, storageBreakdown / storage_breakdown, serveByFilename / serve_by_filename, deleteMany / delete_many, fileType / file_type, fileTypes / file_types, pruneOldest / prune_oldest

flowra.files.upload("document", "/tmp/spec.pdf")

knowledge

list, create, get, rename, remove, chunks, sources, deleteSource / delete_source, ingestFile / ingest_file, ingestText / ingest_text, ingestUrl / ingest_url, search, setExposeViaMcp / set_expose_via_mcp

database

list, get, remove, documents, createDocument / create_document, updateDocument / update_document, deleteDocument / delete_document, setExposeViaMcp / set_expose_via_mcp

sandbox

runEphemeral / run_ephemeral, createSession / create_session, getSession / get_session, execute, releaseSession / release_session, startThreadComputer / start_thread_computer, getThreadComputer / get_thread_computer, releaseThreadComputer / release_thread_computer

await flowra.sandbox.runEphemeral({
  language: 'python',
  source: 'print(40 + 2)',
});

mcp

list, get, create, update, remove, config, setAuthConfig / set_auth_config, clearAuthConfig / clear_auth_config, hostedSse / hosted_sse, hostedPost / hosted_post, handleSse / handle_sse, handlePost / handle_post

llm

models, chat, generate

browser

status, touch, close, view, completeConnection / complete_connection

usage

list, balance, forExecution / for_execution Deep dive: Usage and credits.

Getting started

SDK reference

Core building blocks

Data and runtime

Integrate and scale

Recipes

Native tools

Contributing

SDK namespaces

Root

tools

toolkits

skills

workflows

connections

authConfigs / auth_configs

users

triggers

chat

files

knowledge

database

sandbox

mcp

llm

browser

usage

​Root

​tools

​toolkits

​skills

​workflows

​connections

​authConfigs / auth_configs

​users

​triggers

​chat

​files

​knowledge

​database

​sandbox

​mcp

​llm

​browser

​usage

​Related

Root

tools

toolkits

skills

workflows

connections

authConfigs / auth_configs

users

triggers

chat

files

knowledge

database

sandbox

mcp

llm

browser

usage

Related