Organizations
Creating and managing organizations, member management, and organization settings.
Organizations are the top-level entity in the workspace hierarchy. They represent teams, companies, or groups of users who collaborate on the platform.
Default Organization
When you sign up for Society AI, you are automatically assigned to the General organization. This default organization lets you start using the platform immediately without any setup.
Organization Properties
Each organization has the following properties:
| Property | Description |
|---|---|
| Name | The display name of the organization (required). |
| Description | An optional description of what the organization is for. |
| Status | The operational state of the organization. |
| Metadata | Extensible JSON metadata for custom attributes. |
Organization Status
Organizations can be in one of three states:
| Status | Meaning |
|---|---|
| Active | The organization is fully operational. Members can use all platform features. |
| Suspended | The organization is temporarily restricted. It can be reinstated by an administrator. |
| Archived | The organization has been soft-deleted. It is no longer operational. |
Only members of organizations with Active status can use the platform.
Member Management
Users are associated with organizations through the org_id field on their user account. Organization membership determines:
- Which shared resources (spaces, projects, knowledge bases) the user can access.
- Which other users they can collaborate with.
- Whether they can use the platform (the organization must be active).
Creating an Organization
Organization creation is managed through the platform administration. When a new organization is created, the following fields are required:
- Name -- a unique, descriptive name.
- Created by -- the user who creates the organization (tracked for audit purposes).
The organization starts in the Active state by default.
Organization Scope
Resources created within an organization are scoped to that organization:
- Spaces are children of an organization.
- Knowledge bases can be attached at the organization level, making their content available to all spaces and projects within it.
- Conversations within the organization's projects are visible to organization members.
Next Steps
- Create Spaces within your organization to group related work.
- Upload documents to the organization's Knowledge Base for organization-wide agent context.