---
title: "Organization"
url: "https://rolebase.io/en/api/org"
---

[Rolebase](/) ⟩ [API Reference](/en/api)

 API Reference

# `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 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
    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.