Team Workspaces

Team Workspaces let multiple people share a common environment for running and reviewing debates. Each workspace has its own member list, role hierarchy, settings, and debate history — separate from any individual member's personal debates.

Concepts

Workspace vs Personal Debates

Every user already has a personal debate space tied to their account. Workspaces are a distinct layer on top:

Debates created inside a workspace are scoped to that workspace. Members with appropriate roles can view, fork, and reference workspace debates. Personal debates you run outside a workspace are never visible to workspace members.

Workspace Slug

Every workspace has a unique slug — a lowercase alphanumeric identifier used in URLs. Once set at creation time, the slug cannot be changed. Choose it carefully.

Workspace: "Acme Engineering"
Slug:       acme-engineering

Role Permissions Matrix

Workspaces use a four-level role hierarchy. Every workspace has exactly one owner — the user who created it.

*Members can invite others only when the allowMemberInvites workspace setting is enabled (default: true). Admins and owners can always invite regardless of this setting.

Creating a Workspace

Via API

curl -X POST https://api.askverdict.ai/api/workspaces \
  -H "Authorization: Bearer vrd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Engineering",
    "slug": "acme-engineering",
    "description": "Shared debates for the Acme engineering org"
  }'

Via Web App

1. Go to Settings → Workspaces
2. Click New Workspace
3. Enter a name, slug, and optional description
4. Click Create

You are automatically added as the owner with full permissions.

Inviting Members

curl -X POST https://api.askverdict.ai/api/workspaces/ws_01j9abc123/members \
  -H "Authorization: Bearer vrd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "alice@acme.com",
    "role": "member"
  }'

Listing and Managing Members

List Members

curl https://api.askverdict.ai/api/workspaces/ws_01j9abc123/members \
  -H "Authorization: Bearer vrd_your_api_key"

Change a Member's Role

curl -X PATCH https://api.askverdict.ai/api/workspaces/ws_01j9abc123/members/usr_alice \
  -H "Authorization: Bearer vrd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "role": "admin" }'

Remove a Member

curl -X DELETE https://api.askverdict.ai/api/workspaces/ws_01j9abc123/members/usr_alice \
  -H "Authorization: Bearer vrd_your_api_key"

Workspace Settings

Owners and admins can update workspace settings via PATCH /api/workspaces/:id.

curl -X PATCH https://api.askverdict.ai/api/workspaces/ws_01j9abc123 \
  -H "Authorization: Bearer vrd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Engineering (Updated)",
    "settings": {
      "allowMemberInvites": false,
      "defaultDebateMode": "thorough",
      "requireApprovalForPublicDebates": true
    }
  }'

Workspace Debates

All debates created within a workspace are visible to workspace members. Retrieve them with pagination:

curl "https://api.askverdict.ai/api/workspaces/ws_01j9abc123/debates?page=1&limit=20" \
  -H "Authorization: Bearer vrd_your_api_key"

Deleting a Workspace

Only the owner can delete a workspace. Deletion cascades to all members — debates are soft-deleted and can be recovered within 30 days by contacting support.

curl -X DELETE https://api.askverdict.ai/api/workspaces/ws_01j9abc123 \
  -H "Authorization: Bearer vrd_your_api_key"

Billing

Workspaces are billed per seat under the Team or Business plan.

Each seat corresponds to one workspace member. If your workspace has 8 members (including the owner), you are using 8 of your seats.

Manage your workspace plan at Settings - Billing.

Common Errors