---
title: "List User Workspaces"
api: "GET /v1/api/workspaces"
description: "Retrieve all workspaces the authenticated user owns or is a team member of."
lastUpdated: "2026-11-04"
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://trillet-ai.jamdesk.app/llms.txt). Append `.md` to any page URL for its markdown version.

### Headers

<ParamField header="x-workspace-id" type="string" required>
  The unique identifier of any workspace you are a member of. Required by the auth middleware when using API key authentication. This endpoint still returns all workspaces the authenticated user has access to, regardless of which workspace ID is provided here.
</ParamField>

### Description

This endpoint returns every workspace where the authenticated user is:
- The **owner**,
- An **internal team member**, or
- An **external team member**.

Owned and internal-member workspaces come first, followed by external ones. There is no other sorting.

Before listing, any pending invitation for your email is accepted automatically. If you're a brand-new user with no workspaces and no invitation, a default workspace is created for you. No user is ever created by this endpoint: an unknown user gets `404 {"error": "User not found"}`.

Each workspace object carries many more fields than listed below (billing, plan, white-label and feature settings).

### Response Fields

<ResponseField name="_id" type="string">
  Unique identifier of the workspace.
</ResponseField>

<ResponseField name="name" type="string">
  Name of the workspace.
</ResponseField>

<ResponseField name="initials" type="string">
  Initials of the workspace.
</ResponseField>


<ResponseField name="teamMembers" type="array">
  List of team members associated with the workspace, including their roles and optional external workspace details.
</ResponseField>

<ResponseField name="createdAt" type="string">
  Timestamp when the workspace was created (ISO 8601 format).
</ResponseField>

<ResponseField name="updatedAt" type="string">
  Timestamp when the workspace was last updated (ISO 8601 format).
</ResponseField>


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://trillet-ai.jamdesk.app/api-specs.zip
