Skip to main content
Use the thinkplatform.sdk client to read and update project resources from Python. See Installation to install the CLI and SDK.

​
List your projects

Sign in using a work profile as described in CLI authentication, then load that profile in Python. The SDK acquires credentials through the configured provider. This example only reads resources.
client_from_profile() explicitly reads local CLI configuration. client_from_env() and direct ThinkPlatformClient(...) construction do not load profiles automatically. See SDK authentication for environment configuration and explicit bearer-token credentials.

​
Context and lifecycle

Set org_id and project_id when constructing the client, or pass them to resource methods that accept those keywords. Missing required context raises MissingContextError before a request. See organization and project context for the corresponding CLI settings. client.with_context(org_id=..., project_id=...) returns another client sharing the credential and HTTP connection pool. It preserves an existing context value when the corresponding argument is None; it does not clear it. Keep the original client open while using derived clients. The SDK is synchronous: calls block and there is no public async client. Use with ThinkPlatformClient(...) or call close() to release its HTTP connections. The default request timeout is 30 seconds; set timeout_seconds at construction to change it.

​
Choose a workflow

Continue with authentication, resource methods and examples, database workflows, and error handling. Use the API reference to look up exact method signatures and the models reference to interpret typed results. The SDK and CLI support different sets of operations; some CLI commands have no equivalent SDK method. In client 0.6.133 and later, use Hosted Apps for current-request data access and Lakehouse statements for SQL submission, status and chunks. See Upgrade and migration for compatibility with earlier clients.