An organization holds members, workspaces and the subscription. Most commands take --org; without it they use the checkout's organization or the one you picked with wiele org use.
Roles are owner, admin and member. Owners and admins manage members, invitations, billing and retention. Membership alone gives no access to files. Access comes from workspace visibility or grants, see Sharing and access.
wiele org use
Pick the organization later commands use when you don't pass --org.
wiele org use [flags] <organization>
| Argument |
Description |
<organization> |
Organization ID or slug. |
wiele org list
List the organizations you belong to.
wiele org list [flags]
| Flag |
Description |
--cursor string |
Cursor from the previous page's output. |
--limit integer |
Maximum number of entries per page. Default: 100. |
wiele org show
Show one organization, your role, your membership version and the policy epoch.
wiele org show [flags]
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
wiele org create
Create an organization. You become its owner. New organizations start without a plan.
wiele org create [flags] <name>
| Argument |
Description |
<name> |
Organization name, such as your company's name. |
| Flag |
Description |
--slug string |
Short name, such as acme. Default: the name in lowercase ASCII. |
--idempotency-key string |
UUIDv7 that makes the request safe to retry. Each run generates one; pass the same key to replay a request after a timeout. |
wiele org rename
Rename the organization. The slug never changes.
wiele org rename [flags] <name>
| Argument |
Description |
<name> |
New name. |
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
wiele org logo set
Set the organization logo from a PNG, JPEG or WebP file.
wiele org logo set [flags] <file>
| Argument |
Description |
<file> |
PNG, JPEG or WebP file. |
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
wiele org logo clear
Remove the organization logo.
wiele org logo clear [flags]
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
wiele org activity
List recent pushes, merges and changes across the organization.
wiele org activity [flags]
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
--workspace string |
Workspace ID to limit the list to. |
--before string |
Show events before this cursor, from the previous page. |
--limit integer |
Number of events, at most 200. Default: 50. |
wiele org usage
Show files, storage and push counts per workspace.
wiele org usage [flags]
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
--days integer |
Days of daily push counts to show, 1 to 90. Default: 14. |
wiele org leave
Leave an organization.
wiele org leave [flags]
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
--expected-version integer |
Required. Your membership version, from wiele org show. |
--idempotency-key string |
UUIDv7 that makes the request safe to retry. Each run generates one; pass the same key to replay a request after a timeout. |
wiele org members list
List the organization's members with their roles and versions.
wiele org members list [flags]
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
--cursor string |
Cursor from the previous page's output. |
--limit integer |
Maximum number of entries per page. Default: 100. |
wiele org members set-role
Change a member's organization role.
wiele org members set-role [flags] <user-id>
| Argument |
Description |
<user-id> |
User ID, from wiele org members list. |
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
--expected-version integer |
Required. The member's current version, from wiele org members list. |
--idempotency-key string |
UUIDv7 that makes the request safe to retry. Each run generates one; pass the same key to replay a request after a timeout. |
--role owner|admin|member |
Required. New organization role. |
wiele org members remove
Remove a member from the organization and their access to its workspaces.
wiele org members remove [flags] <user-id>
| Argument |
Description |
<user-id> |
User ID, from wiele org members list. |
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
--expected-version integer |
Required. The member's current version, from wiele org members list. |
--idempotency-key string |
UUIDv7 that makes the request safe to retry. Each run generates one; pass the same key to replay a request after a timeout. |
wiele org invite
Invite someone to the organization, with an organization role and optional content grants.
wiele org invite [flags] <email>
| Argument |
Description |
<email> |
Email address to invite. |
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
--role member|admin|owner |
Organization role. Default: member. |
--grants string |
JSON file with up to 20 grants, such as [{"kind":"resource","resourceId":"res_...","role":"read"}]. |
--idempotency-key string |
UUIDv7 that makes the request safe to retry. Each run generates one; pass the same key to replay a request after a timeout. |
wiele org invitations list
List invitations: every one for owners and admins, the ones you sent for other members.
wiele org invitations list [flags]
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
--cursor string |
Cursor from the previous page's output. |
--limit integer |
Maximum number of entries per page. Default: 100. |
wiele org invitations show
Show one invitation with its state and version.
wiele org invitations show [flags] <invitation-id>
| Argument |
Description |
<invitation-id> |
Invitation ID, such as inv_.... |
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
wiele org invitations accept
Accept an invitation sent to your email address.
wiele org invitations accept [flags] <invitation-id>
| Argument |
Description |
<invitation-id> |
Invitation ID from the email or wiele onboarding status. |
| Flag |
Description |
--idempotency-key string |
UUIDv7 that makes the request safe to retry. Each run generates one; pass the same key to replay a request after a timeout. |
wiele org invitations reject
Turn down an invitation sent to you.
wiele org invitations reject [flags] <invitation-id>
| Argument |
Description |
<invitation-id> |
Invitation ID. |
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
--expected-version integer |
Required. The invitation's current version, from pendingInvitations in wiele onboarding status --json. |
--idempotency-key string |
UUIDv7 that makes the request safe to retry. Each run generates one; pass the same key to replay a request after a timeout. |
wiele org invitations revoke
Withdraw a pending invitation, as an owner, an admin or the person who sent it.
wiele org invitations revoke [flags] <invitation-id>
| Argument |
Description |
<invitation-id> |
Invitation ID. |
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
--expected-version integer |
Required. The invitation's current version, from wiele org invitations show. |
--idempotency-key string |
UUIDv7 that makes the request safe to retry. Each run generates one; pass the same key to replay a request after a timeout. |
wiele org invitations resend
Send a pending invitation's email again, as an owner, an admin or the person who sent it.
wiele org invitations resend [flags] <invitation-id>
| Argument |
Description |
<invitation-id> |
Invitation ID. |
| Flag |
Description |
--org string |
Organization ID or slug. Default: the checkout's organization when the workspace comes from the checkout, otherwise the one picked with wiele org use. |
--expected-version integer |
Required. The invitation's current version, from wiele org invitations show. |
--idempotency-key string |
UUIDv7 that makes the request safe to retry. Each run generates one; pass the same key to replay a request after a timeout. |
wiele org retention is on the retention page.
