org
The top-level entity that contains all other entities such as circles, roles, members, meetings, and tasks.
Fields
| Field | Type | Description |
|---|---|---|
id | uuid | Unique identifier for the organization |
name | String | Name of the organization |
slug | String | URL-friendly unique identifier (optional) |
archivedAt | Timestamp | When the organization was archived; null if active |
createdAt | Timestamp | When the organization was created |
defaultGraphView | String | Default graph view setting (optional) |
governanceMode | governance_mode | Who can change the org chart: Free (all members), Agile (role leaders), Strict (proposals only). Default: Free |
shareMembers | Boolean | Whether member information is publicly shared (default: false) |
shareOrg | Boolean | Whether organization information is publicly shared (default: false) |
Relationships
One-to-One:
org_subscription— The organization’s subscription information
One-to-Many:
circles— Organizational circlesdecisions— Organization decisionsfiles— Organization fileslogs— Activity logsmeeting_templates— Meeting templatesmeetings— Meetingsmeetings_recurring— Recurring meetingsmembers— Organization membersnews— News itemsroles— Organization rolestask_views— Task viewstasks— Tasksthreads— Discussion threads
Query Examples
Get a Specific Organization
query GetOrganization($id: uuid!) {
org_by_pk(id: $id) {
id
name
slug
archivedAt
createdAt
members {
id
name
role
}
circles {
id
name
}
}
}
Mutation Examples
Update an Organization
mutation UpdateOrganization {
update_org_by_pk(
pk_columns: { id: "your-org-id" }
_set: {
name: "New Organization Name"
shareMembers: true
governanceMode: Strict
}
) {
id
name
shareMembers
governanceMode
}
}
Permissions
- Owner: Full access to all organization settings and data
- Admin: Can manage most organization settings and data
- Member: Can view organization data based on sharing settings
Notes
The slug field must be unique across all organizations. The
governanceMode field sets who can change the org chart: Free lets every
member edit it, Agile restricts edits to role leaders, and Strict makes
it read-only so changes go through proposals. Only the Owner can change
governanceMode. The shareMembers and shareOrg flags control visibility
of organization data to external users.