Skip to main content

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:
FieldTypeRequiredDescription
team_slugstrYesWorkspace 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:
FieldTypeRequiredDescription
team_slugstrYesWorkspace slug identifier
pageintNoPage number (1-based)
page_sizeintNoItems 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:
FieldTypeRequiredDescription
team_slugstrYesWorkspace slug identifier
Returns: Workspace quotas response with limits and current usage. Example:
quotas = client.get_workspace_quotas("my-team")
print(quotas.model_dump())