Workspaces
Blockfrost Workspaces enable users to create collaborative spaces for sharing projects with other team members. Set up a workspace for your organization, streamline billing management, and allow developers to concentrate on what matters most - building your application.
Using workspaces
Upon logging in, you'll discover that we've conveniently set up your first workspace, containing all your existing projects. Access to inviting new members or setting up additional workspaces is available for DEVELOPER or ENTERPRISE subscribers.
Add members
Navigate to the dropdown menu and select "Manage workspace", or alternatively, access the workspace settings directly from the dashboard using the available shortcut.
Generate a new invitation link, and upon acceptance, the new member will appear in your workspace. By default, every new member is assigned the Collaborator role. To modify a member's role, simply click on the role dropdown menu and make your selection. See Roles for a description of available roles.
Share projects
Sharing projects is a breeze with workspaces. Simply choose the desired workspace for your project, then follow the steps to Create your first project. All workspace members will have access to projects within the shared workspace.
Manage billing
Billing within a workspace is streamlined, with all workspaces sharing the subscription and allocated quota of their creator. Workspace members can track the quota usage for individual workspaces as well as monitor the overall consumption for the entire subscription.
Workspace owners can delegate billing management to other members by assigning them the Administrator role. Administrators can then log into the billing portal on behalf of the owner to manage subscription and billing information, ensuring a smooth and efficient billing process while allowing developers to focus on building your application.
Subscription changes will affect all workspaces created by the same owner, as workspace subscriptions are tied to the owner rather than the individual workspace.
After a member is assigned the appropriate role, they can access the Billing portal by clicking the "Workspace Billing" button found within the workspace settings.
Transferring ownership
To transfer the ownership of a workspace, navigate to the workspace settings page and click on the three-dot menu located in the top-right corner. Select "Transfer Ownership" to initiate the process.
Please ensure that the selected new owner has a subscription with a sufficient quantity of available resources. Projects within the workspace will utilize resources from the subscription of the new owner, including daily request limits and other associated quotas.
Upon transferring ownership, the new workspace owner will receive the Owner role and your role will be changed to Administrator.
Only an Owner can transfer ownership. If your Owner has left your company or organization, you'll need to reach out to this person for help.
Roles
Blockfrost Workspaces offer four distinct roles, providing a well-organized and efficient collaboration experience:
- Owner - The workspace owner has full permissions, including managing billing, projects, and members. Automatically assigned upon workspace creation, this role cannot be changed or removed by other members.
- Administrator - Administrators possess nearly the same permissions as the Owner. They can manage billing, workspace projects, and members, as well as generate new invites. However, they lack the ability to delete the workspace.
- Maintainer - Maintainers have the ability to create new projects and update or delete existing ones, ensuring efficient project management.
- Collaborator - With read-only access to all workspace projects, Collaborators can review project information without making modifications.
Permission | Owner | Administrator | Maintainer | Collaborator |
---|---|---|---|---|
Workspace - Change name | ✅ | ✅ | ❌ | ❌ |
Workspace - Manage billing | ✅ | ✅ | ❌ | ❌ |
Workspace - Transfer ownership | ✅ | ❌ | ❌ | ❌ |
Workspace - Delete a workspace | ✅ | ❌ | ❌ | ❌ |
Workspace Members - Create an invite link | ✅ | ✅ | ❌ | ❌ |
Workspace Members - Delete an invite link | ✅ | ✅ | ❌ | ❌ |
Workspace Members - Update member's role | ✅ | ✅ | ❌ | ❌ |
Workspace Members - Delete a member | ✅ | ✅ | ❌ | ❌ |
Projects - Add new project | ✅ | ✅ | ✅ | ❌ |
Projects - Update existing project | ✅ | ✅ | ✅ | ❌ |
Projects - Delete a project | ✅ | ✅ | ✅ | ❌ |