Rolebase Developers
API Reference

org

The top-level entity that contains all other entities such as circles, roles, members, meetings, and tasks.

Fields

FieldTypeDescription
iduuidUnique identifier for the organization
nameStringName of the organization
slugStringURL-friendly unique identifier (optional)
archivedAtTimestampWhen the organization was archived; null if active
createdAtTimestampWhen the organization was created
defaultGraphViewStringDefault graph view setting (optional)
governanceModegovernance_modeWho can change the org chart: Free (all members), Agile (role leaders), Strict (proposals only). Default: Free
shareMembersBooleanWhether member information is publicly shared (default: false)
shareOrgBooleanWhether organization information is publicly shared (default: false)

Relationships

One-to-One:

  • org_subscription — The organization’s subscription information

One-to-Many:

  • circles — Organizational circles
  • decisions — Organization decisions
  • files — Organization files
  • logs — Activity logs
  • meeting_templates — Meeting templates
  • meetings — Meetings
  • meetings_recurring — Recurring meetings
  • members — Organization members
  • news — News items
  • roles — Organization roles
  • task_views — Task views
  • tasks — Tasks
  • threads — 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
Info Circle 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.