Organizations
Collaborate with your team using organizations, manage members, and control access with role-based permissions.
Organizations enable team collaboration in RESTK. Create organizations to share workspaces, collections, and requests with your team.
Quick Start
Create Organization
Click Create Organization and enter a name
Invite Team Members
Add team members via email invitations
Create Team Workspaces
Build shared workspaces for your team to collaborate
Note
All organization operations (create, edit, delete) require an internet connection.
Creating an Organization
Navigate to Organizations
Access your organization list from the sidebar or context switcher
Create New
Click Create Organization
Enter Details
Provide an organization name and optionally add a domain
Confirm
Click Create to establish your organization
You automatically become the Owner of organizations you create.
Internet Required
Creating organizations requires an active internet connection.
Organization Roles
Role Permissions
| Role | View Org | Invite Members | Manage Members | Manage Organization | Delete Org |
|---|---|---|---|---|---|
| Owner | Yes | Yes (Any role) | Yes | Yes | Yes |
| Admin | Yes | Yes (Member only) | Yes (Members only) | No | No |
| Member | Yes | No | No | No | No |
Role Hierarchy
Owner (Highest)
- Full control over the organization
- Can manage all members including Admins
- Can delete the organization
- Cannot leave without transferring ownership
Admin
- Can invite and manage Members
- Cannot manage other Admins or the Owner
- Can create and manage workspaces
Member (Standard)
- Can view the organization and work in assigned workspaces
- Cannot manage other members or view the member list
- Cannot create or delete workspaces
Workspace Roles Are Different
Workspace roles (Owner/Manager/Editor/Viewer) are separate from organization roles. See Roles & Permissions for workspace-specific permissions.
Managing Members
Viewing Members
Open Organization
Switch to your organization context
Go to Members
Navigate to the Members tab (Owner/Admin only)
View List
See all active and disabled members with their roles
Permission Required
Only Owners and Admins can view the Members tab. Regular Members cannot access the member list.
Inviting Members
Click Invite
Open the Invite Members dialog
Enter Emails
Add one or more email addresses (comma-separated for bulk invites)
Select Role
Choose Member or Admin (Owners can invite as any role, Admins can only invite as Member)
Send Invitations
Click Send to deliver invitation emails
Invitation Features:
- Invite multiple people at once
- Customize roles per invitation (Owner only)
- Pending invitations appear in the members list
- Invitations can be revoked before acceptance
Changing Member Roles
Locate Member
Find the member in your members list
Click Role Badge
Select the role dropdown
Choose New Role
Select the new role (Member or Admin)
Confirm
Confirm the role change
Role Change Rules:
- Owners can change any member's role
- Admins can only change Member roles (not other Admins)
- You cannot change your own role
- Role changes take effect immediately
Removing Members
Find Member
Locate the member you want to remove
Click Remove
Click the trash icon next to their name
Confirm
Confirm the removal
Removal Rules:
- Cannot remove yourself
- Cannot remove the Owner
- Admins cannot remove other Admins
- Removed members lose access immediately
Immediate Effect
When a member is removed, they lose access to all organization workspaces and data immediately.
Disabling and Enabling Members
Disabling a Member
Locate Member
Find the member in the members list
Click Disable
Click the disable button (slash circle icon)
Confirm
Confirm the disable action in the dialog
What Happens:
- Member account is suspended in the organization
- They lose access to all organization resources
- Their data remains intact
- Shows "Disabled" badge with grayed appearance
- Can be re-enabled later
Disable Permissions:
- Owners can disable any member or admin
- Admins can disable Members only (not other Admins)
- Cannot disable the Owner
- Cannot disable yourself
Disabled vs Removed
Disabling suspends access temporarily while removing deletes the membership permanently. Use disable when you may need to restore access later.
Enabling a Member
Find Disabled Member
Locate the disabled member (shows "Disabled" badge)
Click Enable
Click the green Enable button
Confirm
Confirm to restore access
The member regains immediate access to all organization resources.
Real-Time Access Revocation
When a member is disabled:
- Their next API call returns a
MEMBER_DISABLEDerror - They are immediately logged out of the organization
- Local organization data is cleaned up
- They're automatically switched to personal context
- The organization appears with a "suspended" badge (grayed out)
This ensures instant access revocation without waiting for sync cycles.
Disabled User Experience
When your account is disabled:
- You see a "suspended" badge on the organization
- The organization card appears grayed out
- You cannot access organization workspaces or data
- You're automatically switched to your personal context
- Your local organization data is cleaned up
Re-enabled Access: When an admin re-enables your account, the suspended badge disappears and you can access the organization again.
Offline Not Supported
Disabling and enabling members requires an internet connection. These actions cannot be performed offline.
Invitations
Accepting Invitations
Check Notifications
Look for the notification bell icon
View Invitation
See pending invitations with organization details
Accept
Click Accept to join the organization
You immediately gain access to the organization's workspaces with the assigned role.
Rejecting Invitations
View Invitation
Open your pending invitations
Reject
Click Reject to decline the invitation
The invitation is removed and the organization admin is notified.
Revoking Invitations
As an Owner or Admin:
View Pending Invitations
See pending invitations in the members list
Click Revoke
Click the X to cancel the invitation
The invitee can no longer accept the invitation.
Invitation Codes
You can also join organizations using a 6-character invitation code:
Get Code
Receive the invitation code from your team
Enter Code
Go to Join Organization and enter the code
Join
Click Join to become a member
Switching Contexts
Switch to Organization
Open Context Switcher
Click the context switcher at the top of the sidebar
Select Organization
Choose your organization from the list
Access Resources
Organization workspaces load with your permissions applied
Switch to Personal
Open Context Switcher
Click the context switcher
Select Personal
Choose Personal to return to your individual workspaces
Your last selected context is remembered when you restart the app.
Editing an Organization
Go to Settings
Navigate to organization settings (Owner/Admin only)
Edit Details
Change the organization name or domain
Save
Save your changes
Internet Required
Editing organization details requires an active internet connection.
Deleting an Organization
Go to Settings
Navigate to organization settings (Owner only)
Click Delete
Select Delete Organization
Confirm
Type the organization name to confirm deletion (case-sensitive)
Permanent Action
Deleting an organization removes all members, workspaces, collections, and requests. This cannot be undone.
Deletion Effects:
- All members are removed
- All workspaces and their contents are deleted
- You're redirected to your personal context
- Requires Owner role
Offline Behavior
When offline, you can:
- View cached organization list
- Browse cached organization workspaces
- Switch between organizations
- Work with cached data
When offline, you cannot:
- Create organizations
- Edit organization details
- Invite, remove, disable, or enable members
- Delete organizations
Auto-Sync
All organization changes sync automatically when you reconnect to the internet.
Best Practices
- Clear Naming - Use descriptive organization names like "Acme Engineering" or "Marketing Team"
- Assign Appropriate Roles - Give Admin role only to trusted team members who need management access
- Regular Review - Periodically review your member list to ensure access is current
- Use Disable vs Remove - Disable members for temporary suspension, remove for permanent departure
- Invite by Email - Use email invitations for better tracking and security