Workspace

This file outlines the Flashgate API's workspace management features, including creating, updating, listing, and managing workspaces that group users and resources within an organization. Workspaces support role-based access control with READ, WRITE, and ADMIN permissions.

To perform these operations, you must be authenticated by means of one of the following methods: BearerAuth.

Workspace API Calls

Method	API Reference	Description
POST/workspace	post__workspace	Create a new workspace for the authenticated user's organization.
GET/workspace	get__workspace	Retrieve all workspaces the authenticated user can access.
GET/workspace/{id}	get__workspace_workspaceid	Retrieve a specific workspace by ID.
PUT/workspace/{id}	put__workspace_workspaceid	Update an existing workspace's configuration.
DELETE/workspace/{id}	delete__workspace_workspaceid	Delete a workspace (soft delete).
POST/workspace/{id}/users	post__workspace_wksid_users	Add a user to a workspace with specified role.
PUT/workspace/{id}/users/{userId}	put__workspace_wksid_users_userid	Update a user's role in a workspace.
DELETE/workspace/{id}/users/{userId}	delete__workspace_wksid_users_userid	Remove a user from a workspace.

Workspace Access Types

Access Type	Description
READ	Read-only access to workspace resources
WRITE	Read and write access to workspace resources
ADMIN	Full administrative access including user management

Workspace Management Permissions

• Organization Owners, Administrators, and Workspace Managers can create new workspaces

• Workspace Admins can manage workspace users and update workspace settings

• Workspace Admins can delete workspaces (only if they contain no buckets or repositories)

• Users must have validated accounts to perform workspace operations