---
title: "org | GraphQL API | Rolebase"
description: "Organization, the top-level entity that contains all other entities such as circles, roles, members, meetings, and tasks."
url: "https://rolebase.io/en/developers/graphql-api/org"
---

[Rolebase](/) ⟩[Developers](/en/developers) ⟩[GraphQL API](/en/developers/graphql-api)

# org

Organization, 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 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

** 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.