Documentation Index
Fetch the complete documentation index at: https://docs.phala.com/llms.txt
Use this file to discover all available pages before exploring further.
Workspace methods let you query the workspaces (teams) you belong to, inspect their nodes, and check resource quotas. Every CVM belongs to a workspace, and quotas are enforced at the workspace level.
list_workspaces
GET /workspaces
Lists all workspaces the authenticated user has access to.
Parameters: Optional dictionary of query parameters.
Returns: List of workspace summaries.
Example:
workspaces = client.list_workspaces()
for ws in workspaces.items:
print(ws.slug, ws.name)
get_workspace
GET /workspaces/{teamSlug}
Retrieves detailed information about a specific workspace. You can pass the team slug as a plain string or as a dictionary.
Parameters:
| Field | Type | Required | Description |
|---|
team_slug | str | Yes | Workspace slug identifier |
Returns: Workspace detail response.
Example:
# Pass slug directly as a string
ws = client.get_workspace("my-team")
# Or pass as a dict
ws = client.get_workspace({"team_slug": "my-team"})
print(ws.name)
get_workspace_nodes
GET /workspaces/{teamSlug}/nodes
Lists the TEE nodes available to a workspace. Supports pagination.
Parameters:
| Field | Type | Required | Description |
|---|
team_slug | str | Yes | Workspace slug identifier |
page | int | No | Page number (1-based) |
page_size | int | No | Items per page |
Returns: Paginated list of workspace nodes.
Example:
nodes = client.get_workspace_nodes({
"team_slug": "my-team",
"page": 1,
"page_size": 20,
})
for node in nodes.items:
print(node.id, node.name)
get_workspace_quotas
GET /workspaces/{teamSlug}/quotas
Returns the resource quotas and current usage for a workspace. This includes limits on CVMs, vCPUs, memory, and other resources.
Like get_workspace, you can pass the team slug as a string or dictionary.
Parameters:
| Field | Type | Required | Description |
|---|
team_slug | str | Yes | Workspace slug identifier |
Returns: Workspace quotas response with limits and current usage.
Example:
quotas = client.get_workspace_quotas("my-team")
print(quotas.model_dump())