Workspaces

What is a Workspace?

A workspace is a shared environment where team members can:

• Store and organize files together
• Collaborate with role-based permissions
• Share a dedicated storage pool separate from personal storage

Storage Model

Workspaces use a blocked storage model:

• The workspace owner allocates storage from their personal quota
• This storage is "blocked" (reserved) for the workspace
• Team members contribute files to the shared pool
• When deleted, storage returns to the owner

Workspace Roles

Role	View	Upload	Delete	Manage Members	Settings	Delete Workspace
viewer	✓	✗	✗	✗	✗	✗
editor	✓	✓	✓	✗	✗	✗
admin	✓	✓	✓	✓	✓	✗
owner	✓	✓	✓	✓	✓	✓

Creating a Workspace

Parameters

Parameter	Type	Required	Description
name	string	Yes	Workspace name (max 100 chars)
description	string	No	Workspace description
icon	string	No	Icon identifier
color	string	No	Hex color code
storageAllocation	string	Yes	Storage in bytes (min 100MB)

Response

Listing Workspaces

Response

Filter by Role

Get Workspace Details

Response

Update Workspace

Archive Workspace (Owner Only)

Archived workspaces are read-only but preserve all data.

Delete Workspace

Warning: This permanently deletes:

• All workspace files and folders
• Member associations
• Activity history

Storage is released back to the owner's quota.

Member Management

List Members

Response

Invite Member

Parameters

Parameter	Type	Required	Description
email	string	Yes	User's email address
role	string	Yes	viewer, editor, or admin
message	string	No	Custom invitation message

Notes:

• Only owner can invite admins
• Invitations expire after 7 days
• Email notification sent to invitee

Update Member Role

Remove Member

Invitations

List Your Pending Invitations

Response

Accept Invitation

Reject Invitation

Ownership Transfer

Transfer workspace ownership to another member.

Initiate Transfer

Requirements:

• You must be the current owner
• New owner must be an existing member
• New owner must have enough available storage

Accept Transfer

Reject Transfer

Effects of Transfer:

• Storage allocation moves to new owner's quota
• Previous owner becomes admin
• All activity is logged

Workspace Files

Upload to Workspace

Uses the same presigned URL flow as personal uploads.

List Workspace Files

Move Files To/From Workspace

Activity Log

Track all workspace activity:

Response

Tracked Actions:

• WORKSPACE_CREATED
• WORKSPACE_UPDATED
• WORKSPACE_ARCHIVED
• WORKSPACE_RESTORED
• MEMBER_INVITED
• MEMBER_JOINED
• MEMBER_REMOVED
• MEMBER_LEFT
• MEMBER_ROLE_CHANGED
• FILE_UPLOADED
• FILE_DELETED
• FOLDER_CREATED
• OWNERSHIP_TRANSFERRED

Code Example: Complete Workspace Manager