Skip to main content

​
What are Workspaces?

Workspaces are collaborative work spaces that allow you to organize applications and databases into logical groups and share them with other team members.

​
Roles and Permissions

Each workspace member has a role that defines their access level:

Owner

Full control. Manages members, resources and workspace settings. Can delete the workspace.

Admin

Manages resources and members. Can add/remove members (except the owner).

Developer

Can manage resources (deploy, start, stop, restart) but cannot delete them or manage members.

Operator

Can operate resources (start, stop, restart) and view metrics. No access to settings.
Additionally, the Viewer () role offers read-only access to resources and metrics.

​
Permissions Matrix

ActionOwnerAdminDeveloperOperatorViewer
View resources and metrics✅✅✅✅✅
Start / Stop / Restart✅✅✅✅❌
Deploy and configure✅✅✅❌❌
Manage members✅✅❌❌❌
Delete resources✅✅❌❌❌
Delete workspace✅❌❌❌❌

​
Creating a Workspace

1

Access Workspaces

In the dashboard sidebar menu, access the “Workspaces” section.
2

Create New

Click “New Workspace” and define a name and description.
3

Invite Members

Add members by providing the user identifier and selecting the desired role. You can generate an invite link to facilitate.
4

Assign Resources

Associate existing applications and databases to the workspace.
Workspace creation is available starting from the Enterprise plan. The maximum number of members varies according to the plan (5 to 24 members).

​
Member Management

Access the workspace → Members → Add, remove or change roles. Changes are applied immediately.

​
Resources in Workspace

Applications and databases can be associated with a workspace during creation or later.
Use the API to link an application or database to the workspace:
# Add app to workspace
curl -X POST -H "Authorization: Bearer TOKEN" \
     https://api.vertracloud.app/v1/workspaces/{workspace_id}/apps/{app_id}

# Add database to workspace
curl -X POST -H "Authorization: Bearer TOKEN" \
     https://api.vertracloud.app/v1/workspaces/{workspace_id}/databases/{db_id}
Removing a resource from a workspace does not delete it — it simply stops being associated:
curl -X DELETE -H "Authorization: Bearer TOKEN" \
     https://api.vertracloud.app/v1/workspaces/{workspace_id}/apps/{app_id}
A resource can belong to only one workspace at a time. To move a resource between workspaces, remove it from the current one and add it to the new one.