GET
/
v1
/
api
/
workspaces
/
{x-workspace-id}
curl --request GET \
  --url https://api.trillet.ai/v1/api/workspaces/{x-workspace-id} \
  --header 'x-api-key: <api-key>' \
  --header 'x-workspace-id: <x-workspace-id>'
{
  "_id": "<string>",
  "name": "<string>",
  "initials": "<string>",
  "pricingTier": "<string>",
  "isMasterWorkspace": true,
  "teamMembers": [
    {}
  ],
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

​
Path Parameters

​
x-workspace-id
string
required

The unique identifier of the workspace to retrieve.

​
Headers

​
x-workspace-id
string
required

The unique identifier of the workspace being accessed (should match the path parameter :workspaceId).

​
Description

This endpoint returns the details of a specific workspace if the authenticated user is authorized to access it. The user must be either:

  • The owner of the workspace, or
  • A team member of the workspace (internal or external).

If the workspace is not found or the user lacks permission, a 404 Not Found is returned.

​
Response Fields

​
_id
string

Unique identifier of the workspace.

​
name
string

Name of the workspace.

​
initials
string

Initials of the workspace.

​
pricingTier
string

Pricing tier of the workspace (e.g., “build_plan”).

​
isMasterWorkspace
boolean

Indicates whether this is the master workspace.

​
teamMembers
array

List of team members associated with the workspace.

​
createdAt
string

ISO 8601 timestamp when the workspace was created.

​
updatedAt
string

ISO 8601 timestamp when the workspace was last updated.