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) |
archived | Boolean | Whether the organization is archived (default: false) |
createdAt | Timestamp | When the organization was created |
defaultGraphView | String | Default graph view setting (optional) |
protectGovernance | Boolean | Whether governance changes are restricted to leaders (default: false) |
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
archived
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
protectGovernance: true
}
) {
id
name
shareMembers
protectGovernance
}
}
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. When
protectGovernance is enabled, only circle leaders can modify
governance-related entities. The shareMembers and shareOrg flags control
visibility of organization data to external users.