# Organizations

URL: https://heaven.dev/docs/reference/organizations
Updated: 2026-11-21

An organization owns pools and Computers and pays for their capacity. Roles determine each member's access.

## Read

| Request | What it does |
| --- | --- |
| [List or read organizations](https://heaven.dev/docs/reference/organizations/view) | List the organizations you belong to and your role in each. |
| [Read an organization's usage](https://heaven.dev/docs/reference/organizations/usage) | Read an organization's pool usage and capacity charges for the month so far, starting at midnight UTC on the first. |
| [Read the audit log](https://heaven.dev/docs/reference/organizations/audit-view) | Read the account's record of changes. |

## Create and close

| Request | What it does |
| --- | --- |
| [Create an organization](https://heaven.dev/docs/reference/organizations/create) | Create an empty organization with yourself as billing owner. |
| [Close an organization](https://heaven.dev/docs/reference/organizations/delete) | Close an organization as its billing owner. |

## Name and settings

| Request | What it does |
| --- | --- |
| [Rename an organization](https://heaven.dev/docs/reference/organizations/rename) | Rename an organization. |
| [Change an organization's setting](https://heaven.dev/docs/reference/organizations/setting) | Set who can share Computers outside the organization or invite people from outside it to its teams. |

## Members

| Request | What it does |
| --- | --- |
| [List members](https://heaven.dev/docs/reference/organizations/member-view) | List an organization's members, their roles, additional commands and withheld commands. |
| [Invite a member](https://heaven.dev/docs/reference/organizations/member-add) | Invite someone to an organization with a role, command permissions and optional team membership. |
| [Change a member's access](https://heaven.dev/docs/reference/organizations/member-role) | Change an organization member's role and replace their granted and withheld commands. |
| [Remove a member](https://heaven.dev/docs/reference/organizations/member-remove) | Remove an organization member or cancel their pending invitation. |
| [Leave an organization](https://heaven.dev/docs/reference/organizations/leave) | Leave an organization and transfer your Computers. |

## Invitations and join links

| Request | What it does |
| --- | --- |
| [List sent invitations](https://heaven.dev/docs/reference/organizations/invitation-view) | List unexpired, unanswered invitations to an organization and its teams. |
| [Cancel an invitation](https://heaven.dev/docs/reference/organizations/invitation-cancel) | Withdraw pending organization or team invitations. |
| [Get a join link](https://heaven.dev/docs/reference/organizations/link-add) | Get an active organization join link or create one that lasts seven days. |
| [List join links](https://heaven.dev/docs/reference/organizations/link-view) | List active organization join links. |
| [Remove a join link](https://heaven.dev/docs/reference/organizations/link-remove) | Revoke an organization's join links to stop more people joining through them. |
