Organizations & Projects
TouAI is organized as organization → projects → API keys. Every project API key belongs to exactly one organization and one project. Organizations, projects, members, and roles are managed in the web console — there are no organization-management APIs in the SDK.
The Console-Managed Model
Create an organization
Each organization owns one credit wallet, its subscription plan, and its members.
Create projects
Projects partition an organization's data and usage. Members hold per-project roles: viewer (read), member (write), admin (delete and audit).
Issue project API keys
Create an API key inside a project and use it with the SDK. The key carries its organization and project — no IDs to pass on every call.
How the Key's Project Shapes SDK Calls
The key's project is the default context everywhere:
from touai import TouAI
client = TouAI() # a project API key
# Object storage writes land in the key's project automatically
stored = client.object_storage.store(open("data.csv", "rb"))
# Another project the key can access can be targeted explicitly
other = client.object_storage.project("proj_01H...")
buckets = other.buckets()
# Billing reads are scoped the same way: a project key sees its own
# project's usage and transactions
usage = client.billing.credits.usage_by_project()
txns = client.billing.credits.project_transactions("proj_01H...")Jobs, files, and search results across all services are likewise scoped to the key's organization and project — two project keys of the same organization see disjoint resources.
To work in a different project, create an API key in that project (web console) or use a key whose project role grants access, e.g. via client.object_storage.project(...).