Trillet AI logo

List User Workspaces

Retrieve all workspaces associated with the authenticated user. If the user does not exist, a new user and default workspace may be automatically created.

GEThttps://api.trillet.ai/v1/api/workspaces

Headers

x-workspace-idstringrequired

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.

Description

This endpoint returns a list of workspaces where the authenticated user is either:

  • The owner of the workspace,
  • An internal team member, or
  • An external team member.

If the user is signing in for the first time, the system will:

  1. Check for any pending invitations and join the user to an existing workspace if one exists.
  2. If no invitation exists, create a default workspace for the user.

The response includes both direct workspaces and external workspaces, sorted in the following order:

  1. Owned workspaces,
  2. Team memberships,
  3. Guest workspaces.

Response Fields

_idstring

Unique identifier of the workspace.

namestring

Name of the workspace.

initialsstring

Initials of the workspace.

teamMembersarray

List of team members associated with the workspace, including their roles and optional external workspace details.

createdAtstring

Timestamp when the workspace was created (ISO 8601 format).

updatedAtstring

Timestamp when the workspace was last updated (ISO 8601 format).