Organizations
Organizations are the top-level tenancy, governance, usage, and billing boundary in Computer Agents. Select an organization to work with its members, agents, computers, projects, and deployed resources through the platform, API, or SDK.
The organization boundary
An active organization gives every platform request one explicit company context. Resources created in that context belong to the organization and are isolated from resources in other organizations.
Resource boundary
Agents, computers, projects, files, metronomes, databases, and other resources are resolved inside the active organization.
Membership boundary
Members join the company workspace once and receive an organization role that governs platform-level access.
Usage and billing boundary
Usage, USD credit balance, reservations, budgets, and billing controls can be managed for the organization as a whole.
Governance boundary
Owners and admins manage organization metadata, invitations, membership, and the teams used for narrower sharing rules.
Every user starts with a personal organization
Existing and new accounts continue to work without any migration step. When an API request omits organization context, Computer Agents lazily resolves or creates the authenticated user's personal organization. It behaves like the user's default workspace and receives the standard default resources.
Organizations and teams solve different problems
Organizations define where company data, resources, usage, and billing live. Teams are groups inside that boundary and provide narrower collaboration and resource-sharing policies.
Select an organization for SDK and API requests
Initialize a client with an organization ID or derive a scoped client with withOrganization(). The scoped client automatically sends the organization header on subsequent resource requests.
If the header is omitted, the request uses your personal organization. Supplying an organization where you are not an active member returns a forbidden response.
Create and manage organizations
The organizations SDK resource lists available organizations, resolves the current context, and manages company organization metadata.
Members and roles
Organization membership is separate from team membership. Every active organization member has one organization-level role; teams then refine access to dedicated resources and projects.
Invite members
Owners and admins can invite a person by email and assign the initial organization role. The recipient can accept or decline the pending invitation while authenticated with the invited email address.
Organization API endpoints
Organization management is available under /v1/organizations. All endpoints require an authenticated Computer Agents API key.