Tenants
A tenant is your organizational workspace in RestAPI.com. It's a container for APIs, team members, and support tickets.
What's in a Tenant
| Content | Description |
|---|---|
| APIs | Your backend services |
| Users | Team members with assigned access levels |
| Support Tickets | Support requests for APIs in this tenant |
Creating a Tenant
Your first tenant is created automatically when you sign in. To create additional tenants:
- Click Create Tenant from the tenants page
- Enter a tenant name
- Click Create
You become the owner of any tenant you create.
Joining a Tenant
To join an existing tenant, you need an invitation:
- Ask a tenant administrator to invite you
- You'll receive an invitation code
- Click Join Tenant and enter the code
- You're added to the tenant with the assigned access level
Access Levels
| Level | Permissions |
|---|---|
| Administrator | Full control: manage users, APIs, settings, billing |
| Member | Create and manage APIs, but cannot manage tenant settings |
| Guest | View-only access to tenant resources |
Managing Users
Administrators can manage tenant users:
Inviting Users
- Go to Tenant Users
- Click Invite User
- Enter email and select access level
- Send invitation
The invited user receives a code to join the tenant.
Changing Access
- Go to Tenant Users
- Find the user
- Click to edit their access level
- Save changes
Removing Users
- Go to Tenant Users
- Find the user
- Click Remove
- Confirm removal
Tenant Overview
The tenant overview page shows:
- Tenant name and account number
- Owner information
- Creation date and region
- Number of APIs
- Number of users
- Pending invitations
- Open support tickets
- Payment method status
Editing a Tenant
Administrators can edit tenant details:
- Click Edit on the tenant overview
- Update the tenant name or other settings
- Save changes
Leaving a Tenant
To leave a tenant you're a member of:
- Go to the tenant overview
- Click Leave Tenant
- Confirm your departure
If you're the only administrator, you cannot leave without first assigning another administrator or deleting the tenant.
Deleting a Tenant
Only tenant administrators can delete a tenant:
- Go to the tenant overview
- Click Delete Tenant
- Confirm deletion
Deleting a tenant permanently removes all APIs, data, and configurations within it. This action cannot be undone.
Multiple Tenants
You can be a member of multiple tenants simultaneously:
- Personal tenant for your own projects
- Work tenant for your organization
- Client tenants for consulting work
Switch between tenants from the tenants list in the portal.