Integration and flow commands - ThinkPlatform Docs

These examples assume an authenticated active saved profile with the intended organization and project. Confirm it with tp context show before running commands. Add root --json before the command when machine parsing needs JSON output; use root --profile <name> only to override the active profile.

Check context and discover resources

tp auth whoami
tp context show
tp modules list
tp flows list
tp hooks list
tp webhooks list
tp api operations

Modules

tp modules list
tp modules get <module_id>
tp modules invoke <module_id> --tool <tool_name> --input @payload.json

Python SDK pattern for multi-step logic:

from thinkplatform.sdk import client_from_env

tp = client_from_env()
result = tp.modules.invoke(
    "<module_id>",
    "<tool_name>",
    input_data={"query": "status"},
).result
print(result)

Flows

tp flows create --name "Example flow" --body @flow.json --dry-run
tp flows create --name "Example flow" --body @flow.json
tp flows save <flow_id> --data @flow-data.json --dry-run
tp flows save <flow_id> --data @flow-data.json
tp flows run <flow_id> --input @input.json

Use Code Flow for arbitrary Python backend logic and graph Flow for inspectable orchestration.

API fallback

Discover before calling raw routes:

tp api operations --tag "<tag>"
tp api show <operation_id>
tp api call <operation_id> --body @payload.json
tp rest GET /api/...
tp rest POST /api/... --body @payload.json
tp raw get /api/...
tp raw post /api/... --body @payload.json

Event integration

tp automation hooks create --body @hook.json --dry-run
tp automation hooks invoke <hook_id> --body @sample-event.json
tp automation hooks deliveries <hook_id>

tp automation webhooks event-types
tp automation webhooks create --body @webhook.json --dry-run
tp automation webhooks test <subscription_id> --body @event.json
tp automation webhooks deliveries <subscription_id>

Verification checklist

Read schemas/tool definitions before payload creation.
Check that sample inputs and outputs match the expected structure.
Run one controlled invocation.
Inspect Flow run, hook delivery, webhook delivery, or Module result.
Record exact payload file and resource IDs for repeatability.