# Organization commands

Create organizations, list members, and send or answer invitations.

The guide is [Organizations](https://sailfork.com/docs/organizations).

## sailfork org

Create organizations, invite people and answer invitations.

### sailfork org create

Create an organization you own. Changes something. Supports `--dry-run`.

```sh
sailfork org create <HANDLE> [flags]
```

| Argument | What it is |
| --- | --- |
| `<HANDLE>` | Handle for the organization, 1 to 39 letters, digits and hyphens |

| Flag | What it does |
| --- | --- |
| `--name <NAME>` | Display name (default: the handle) |
| `--tagline <TAGLINE>` | One line about the organization. |
| `--time-zone <ZONE>` | IANA time zone name, such as America/Los_Angeles (default: UTC) |
| `--dry-run` | Say what would be created and change nothing. |

Examples:

```sh
sailfork org create acme --name "Acme Inc"
sailfork org create acme --time-zone America/Los_Angeles --dry-run
```

### sailfork org list

List the organizations you belong to. Also `org ls`. Read-only.

```sh
sailfork org list
```

Examples:

```sh
sailfork org list
sailfork org list --json=handle,role
```

### sailfork org view

Show an organization. Read-only.

```sh
sailfork org view <HANDLE>
```

| Argument | What it is |
| --- | --- |
| `<HANDLE>` | Organization handle |

Examples:

```sh
sailfork org view acme
sailfork org view acme --json
```

### sailfork org members

List an organization's members. Read-only.

```sh
sailfork org members <HANDLE>
```

| Argument | What it is |
| --- | --- |
| `<HANDLE>` | Organization handle |

Examples:

```sh
sailfork org members acme
sailfork org members acme --json=handle,role
```

### sailfork org invite

Invite a person to an organization, by email or Sailfork handle (owners). Changes something. Supports `--dry-run`.

```sh
sailfork org invite <HANDLE> <WHO> [flags]
```

| Argument | What it is |
| --- | --- |
| `<HANDLE>` | Organization handle |
| `<WHO>` | An email address, or the handle of someone who has an account |

| Flag | What it does |
| --- | --- |
| `--role <ROLE>` | Role the person joins with. One of `member`, `owner`. Default `member`. |
| `--dry-run` | Say what would be sent and change nothing. |

Examples:

```sh
sailfork org invite acme dana@example.com
sailfork org invite acme dana --role owner
sailfork org invite acme dana@example.com --dry-run
```

### sailfork org invites list

An organization's pending invitations (owners), or without a handle the invitations sent to you. Also `org invites ls`. Read-only.

```sh
sailfork org invites list [HANDLE]
```

| Argument | What it is |
| --- | --- |
| `[HANDLE]` | Organization handle; leave out to list your own invitations |

Examples:

```sh
sailfork org invites list
sailfork org invites list acme --json
```

### sailfork org invites revoke

Withdraw an invitation (owners). Also `org invites rm`. Changes something.

```sh
sailfork org invites revoke <HANDLE> <ID>
```

| Argument | What it is |
| --- | --- |
| `<HANDLE>` | Organization handle |
| `<ID>` | Invitation id, from `org invites list HANDLE` |

Examples:

```sh
sailfork org invites revoke acme 7d2c1a9e-4b5f-4c1d-9a3e-0f6b8d2e1c47
```

### sailfork org invites accept

Join an organization you were invited to. Changes something.

```sh
sailfork org invites accept <INVITE>
```

| Argument | What it is |
| --- | --- |
| `<INVITE>` | Invitation id from `org invites list`, or the organization's handle |

Examples:

```sh
sailfork org invites accept acme
sailfork org invites accept 7d2c1a9e-4b5f-4c1d-9a3e-0f6b8d2e1c47
```

### sailfork org invites decline

Turn down an invitation. Changes something.

```sh
sailfork org invites decline <INVITE>
```

| Argument | What it is |
| --- | --- |
| `<INVITE>` | Invitation id from `org invites list`, or the organization's handle |

Examples:

```sh
sailfork org invites decline acme
```

---

Every docs page: https://sailfork.com/llms.txt
