For AI agents: the complete documentation index is at llms.txt. Remove the trailing slash from a page URL and append .md to read its Markdown version. For the docs home, use index.md.
Newxy is now in Reflex Build (opens in a new tab)
Reflex LogoDocs Logo

reflex-build-sdk Changelog

v0.0.2 (2026-09-18)

Breaking Changes

  • The clients are now named ReflexBuild and AsyncReflexBuild, and the base exception ReflexBuildError, matching the Reflex Build product they talk to. Rename the imports to upgrade:
    • from reflex_build_sdk import AsyncReflexBuild, ReflexBuild, ReflexBuildError
  • The REFLEX_CLOUD_BACKEND_URL and REFLEX_CLOUD_URL environment variables keep working. (#7201)

Features

  • The client reads its URLs from REFLEX_BUILD_BACKEND_URL and REFLEX_BUILD_URL, falling back to REFLEX_CLOUD_BACKEND_URL and REFLEX_CLOUD_URL, which reflex-hosting-cli reads. Set both names when the SDK and reflex deploy should reach the same backend, since the CLI does not read the REFLEX_BUILD_* names. (#7201)

v0.0.1 (2026-09-18)

Features

  • Add the reflex-build-sdk package: ReflexCloud and AsyncReflexCloud clients for the Reflex Cloud API, starting with auth.me() and access token management (auth.tokens.create/list/delete), with typed models, typed errors, and retries for requests that are safe to repeat. The async client sends requests with aiohttp and the sync client with httpx; pass a transport from reflex_build_sdk.transports to configure or replace the HTTP library. (#7166)
  • Add app, secret and project management to reflex-build-sdk: client.apps (list, search, get, create, delete, start, stop, pause, scale, rollback, deployment history, and runtime logs as an iterator), client.apps.secrets, and client.projects with its roles and members. (#7169)
  • Deploy apps with reflex-build-sdk: client.deployments.create streams a build's archives to storage and submits the deployment, and client.deployments.wait follows it until it is running or awaiting approval, raising DeploymentFailedError with the failure report if it fails, or DeploymentTimeoutError when the timeout passes first. The client also reads deployment status, reports and build logs, lists regions and machine sizes, and reserves hostnames with client.apps.reserve_hostname. (#7172)
  • Log in and review code with reflex-build-sdk: client.auth.begin_login and finish_login run the browser login, and the public reflex_build_sdk.credentials module loads, saves and deletes the token reflex login shares. client.security_reviews submits source code for a security review and waits for the result. client.providers reads Google Cloud deploy status, connected provider accounts and the Cloud Run manifest, client.apps sets an app's hosting provider, full deploy and instance bounds, client.deployments.check validates deployment settings before a build, and client.auth.me takes a source for login analytics. (#7175)
  • Manage more of an app with reflex-build-sdk: client.apps renames, describes and moves apps, sets instance persistence, the rollout strategy, the Cloud Run service name and the weekly report, and reads an app's lifecycle status and running deployment. client.apps.domains adds, checks and removes custom domains. (#7180)
  • Deploy through environments with reflex-build-sdk: client.apps.environments enables, lists, creates, updates, reorders and deletes an app's environments, promotes a version to the next one and copies missing secrets. client.apps.database creates, reads and deletes an app's managed Postgres database. (#7181)
  • Sign an app's users in with reflex-build-sdk: client.apps.sign_in enables and disables sign-in with Reflex accounts, sets who may sign in, manages invitations, and lists, exports, blocks and unblocks the app's users. (#7182)
  • Manage project access with reflex-build-sdk: client.projects renames and deletes projects and reads audit logs, projects.roles creates, updates, previews and deletes custom roles, projects.members removes members and reads a member's effective permissions, and projects.teams lists, grants and revokes organization teams' roles. (#7183)
  • Manage an organization's Google Cloud and your tokens with reflex-build-sdk: client.providers connects and disconnects Google Cloud and lists the apps blocking removal, and providers.gcp_connections adds, updates, verifies, rotates keys of, sets the default of and removes connections. client.auth.tokens revokes and refreshes tokens and assigns them to service accounts, and client.usage reads the plan allowance balance and usage history. (#7184)
  • Publish the SDK as reflex-build-sdk, imported as reflex_build_sdk. (#7191)
  • Call third-party services from an app with reflex-build-sdk: client.apps.connections reads a live credential for the app or for one of its users, lists what is connected, starts a connection and disconnects it, without the app ever holding the provider's key. APIStatusError.code now carries the condition the API names for a refusal, such as not_connected. (#7192)