@blaxel/core 0.2.59-preview.42 → 0.2.59-preview.43

package/dist/cjs/client/sdk.gen.js

@@ -2,11 +2,12 @@
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.updateModel = exports.getModel = exports.deleteModel = exports.createModel = exports.listModels = exports.listMcpHubDefinitions = exports.listLocations = exports.listJobRevisions = exports.getJobExecution = exports.deleteJobExecution = exports.createJobExecution = exports.listJobExecutions = exports.updateJob = exports.getJob = exports.deleteJob = exports.createJob = exports.listJobs = exports.getIntegrationConnectionModel = exports.listIntegrationConnectionModels = exports.getIntegrationConnectionModelEndpointConfigurations = exports.updateIntegrationConnection = exports.getIntegrationConnection = exports.deleteIntegrationConnection = exports.createIntegrationConnection = exports.listIntegrationConnections = exports.getIntegration = exports.deleteImageTag = exports.getImage = exports.deleteImage = exports.listImages = exports.cleanupImages = exports.listFunctionRevisions = exports.updateFunction = exports.getFunction = exports.deleteFunction = exports.createFunction = exports.listFunctions = exports.verifyCustomDomain = exports.updateCustomDomain = exports.getCustomDomain = exports.deleteCustomDomain = exports.createCustomDomain = exports.listCustomDomains = exports.getConfiguration = exports.listAgentRevisions = exports.updateAgent = exports.getAgent = exports.deleteAgent = exports.createAgent = exports.listAgents = void 0;
-exports.deleteWorkspace = exports.createWorkspace = exports.listWorkspaces = exports.getVolume = exports.deleteVolume = exports.createVolume = exports.listVolumes = exports.deleteVolumeTemplateVersion = exports.updateVolumeTemplate = exports.getVolumeTemplate = exports.deleteVolumeTemplate = exports.createVolumeTemplate = exports.listVolumeTemplates = exports.updateWorkspaceUserRole = exports.removeWorkspaceUser = exports.inviteWorkspaceUser = exports.listWorkspaceUsers = exports.getTemplate = exports.listTemplates = exports.deleteApiKeyForServiceAccount = exports.createApiKeyForServiceAccount = exports.listApiKeysForServiceAccount = exports.updateWorkspaceServiceAccount = exports.deleteWorkspaceServiceAccount = exports.createWorkspaceServiceAccount = exports.getWorkspaceServiceAccounts = exports.stopSandbox = exports.startSandbox = exports.deleteSandboxPreviewToken = exports.createSandboxPreviewToken = exports.listSandboxPreviewTokens = exports.updateSandboxPreview = exports.getSandboxPreview = exports.deleteSandboxPreview = exports.createSandboxPreview = exports.listSandboxPreviews = exports.updateSandbox = exports.getSandbox = exports.deleteSandbox = exports.createSandbox = exports.listSandboxes = exports.listSandboxHubDefinitions = exports.listPublicIps = exports.listAllPendingInvitations = exports.updatePolicy = exports.getPolicy = exports.deletePolicy = exports.createPolicy = exports.listPolicies = exports.listModelRevisions = void 0;
-exports.checkWorkspaceAvailability = exports.leaveWorkspace = exports.acceptWorkspaceInvitation = exports.declineWorkspaceInvitation = exports.updateWorkspace = exports.getWorkspace = void 0;
+exports.updateWorkspace = exports.getWorkspace = exports.deleteWorkspace = exports.createWorkspace = exports.listWorkspaces = exports.getVolume = exports.deleteVolume = exports.createVolume = exports.listVolumes = exports.deleteVolumeTemplateVersion = exports.updateVolumeTemplate = exports.getVolumeTemplate = exports.deleteVolumeTemplate = exports.createVolumeTemplate = exports.listVolumeTemplates = exports.updateWorkspaceUserRole = exports.removeWorkspaceUser = exports.inviteWorkspaceUser = exports.listWorkspaceUsers = exports.getTemplate = exports.listTemplates = exports.deleteApiKeyForServiceAccount = exports.createApiKeyForServiceAccount = exports.listApiKeysForServiceAccount = exports.updateWorkspaceServiceAccount = exports.deleteWorkspaceServiceAccount = exports.createWorkspaceServiceAccount = exports.getWorkspaceServiceAccounts = exports.deleteSandboxPreviewToken = exports.createSandboxPreviewToken = exports.listSandboxPreviewTokens = exports.updateSandboxPreview = exports.getSandboxPreview = exports.deleteSandboxPreview = exports.createSandboxPreview = exports.listSandboxPreviews = exports.updateSandbox = exports.getSandbox = exports.deleteSandbox = exports.createSandbox = exports.listSandboxes = exports.listSandboxHubDefinitions = exports.listPublicIps = exports.listAllPendingInvitations = exports.updatePolicy = exports.getPolicy = exports.deletePolicy = exports.createPolicy = exports.listPolicies = exports.listModelRevisions = void 0;
+exports.checkWorkspaceAvailability = exports.leaveWorkspace = exports.acceptWorkspaceInvitation = exports.declineWorkspaceInvitation = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * List all agents
+ * Returns all AI agents deployed in the workspace. Each agent includes its deployment status, runtime configuration, and global inference endpoint URL.
  */
 const listAgents = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -22,7 +23,8 @@ const listAgents = (options) => {
 };
 exports.listAgents = listAgents;
 /**
- * Create agent by name
+ * Create agent
+ * Creates a new AI agent deployment from your code. The agent will be built and deployed as a serverless auto-scaling endpoint. Use the Blaxel CLI 'bl deploy' for a simpler deployment experience.
  */
 const createAgent = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -42,7 +44,8 @@ const createAgent = (options) => {
 };
 exports.createAgent = createAgent;
 /**
- * Delete agent by name
+ * Delete agent
+ * Permanently deletes an agent and all its deployment history. The agent's inference endpoint will immediately stop responding. This action cannot be undone.
  */
 const deleteAgent = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -58,7 +61,8 @@ const deleteAgent = (options) => {
 };
 exports.deleteAgent = deleteAgent;
 /**
- * Get agent by name
+ * Get agent
+ * Returns detailed information about an agent including its current deployment status, configuration, events history, and inference endpoint URL.
  */
 const getAgent = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -74,7 +78,8 @@ const getAgent = (options) => {
 };
 exports.getAgent = getAgent;
 /**
- * Update agent by name
+ * Update agent
+ * Updates an agent's configuration and triggers a new deployment. Changes to runtime settings, environment variables, or scaling parameters will be applied on the next deployment.
  */
 const updateAgent = (options) => {
     return (options.client ?? client_gen_1.client).put({
@@ -110,7 +115,8 @@ const listAgentRevisions = (options) => {
 };
 exports.listAgentRevisions = listAgentRevisions;
 /**
- * List all configurations
+ * Get platform configuration
+ * Returns global platform configuration including available regions, countries, continents, and private locations for deployment policies.
  */
 const getConfiguration = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -126,7 +132,8 @@ const getConfiguration = (options) => {
 };
 exports.getConfiguration = getConfiguration;
 /**
- * List all custom domains
+ * List custom domains
+ * Returns all custom domains configured in the workspace. Custom domains allow serving preview deployments under your own domain (e.g., preview.yourdomain.com).
  */
 const listCustomDomains = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -143,6 +150,7 @@ const listCustomDomains = (options) => {
 exports.listCustomDomains = listCustomDomains;
 /**
  * Create custom domain
+ * Creates a new custom domain for preview deployments. After creation, you must configure DNS records and verify domain ownership before it becomes active.
  */
 const createCustomDomain = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -230,7 +238,8 @@ const verifyCustomDomain = (options) => {
 };
 exports.verifyCustomDomain = verifyCustomDomain;
 /**
- * List all functions
+ * List all MCP servers
+ * Returns all MCP server functions deployed in the workspace. Each function includes its deployment status, transport protocol (websocket or http-stream), and endpoint URL.
  */
 const listFunctions = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -246,7 +255,8 @@ const listFunctions = (options) => {
 };
 exports.listFunctions = listFunctions;
 /**
- * Create function
+ * Create MCP server
+ * Creates a new MCP server function deployment. The function will expose tools via the Model Context Protocol that can be used by AI agents. Supports streamable HTTP transport.
  */
 const createFunction = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -266,7 +276,8 @@ const createFunction = (options) => {
 };
 exports.createFunction = createFunction;
 /**
- * Delete function by name
+ * Delete MCP server
+ * Permanently deletes an MCP server function and all its deployment history. Any agents using this function's tools will no longer be able to invoke them.
  */
 const deleteFunction = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -282,7 +293,8 @@ const deleteFunction = (options) => {
 };
 exports.deleteFunction = deleteFunction;
 /**
- * Get function by name
+ * Get MCP server
+ * Returns detailed information about an MCP server function including its deployment status, available tools, transport configuration, and endpoint URL.
  */
 const getFunction = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -298,7 +310,8 @@ const getFunction = (options) => {
 };
 exports.getFunction = getFunction;
 /**
- * Update function by name
+ * Update MCP server
+ * Updates an MCP server function's configuration and triggers a new deployment. Changes to runtime settings, integrations, or transport protocol will be applied on the next deployment.
  */
 const updateFunction = (options) => {
     return (options.client ?? client_gen_1.client).put({
@@ -335,8 +348,8 @@ const listFunctionRevisions = (options) => {
 };
 exports.listFunctionRevisions = listFunctionRevisions;
 /**
- * Cleanup unused images
- * Deletes all unused images in the workspace. Only removes images that are not currently being used by any agents, functions, sandboxes, or jobs.
+ * Cleanup unused container images
+ * Cleans up unused container images in the workspace registry. Only removes images that are not currently referenced by any active agent, function, sandbox, or job deployment.
  */
 const cleanupImages = (options) => {
     return (options?.client ?? client_gen_1.client).delete({
@@ -352,8 +365,8 @@ const cleanupImages = (options) => {
 };
 exports.cleanupImages = cleanupImages;
 /**
- * List images
- * Returns a list of all images in the workspace grouped by repository with tags.
+ * List container images
+ * Returns all container images stored in the workspace registry, grouped by repository with their available tags. Images are created during deployments of agents, functions, sandboxes, and jobs.
  */
 const listImages = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -369,8 +382,8 @@ const listImages = (options) => {
 };
 exports.listImages = listImages;
 /**
- * Delete image by name
- * Deletes an image by name.
+ * Delete container image
+ * Deletes a container image and all its tags from the workspace registry. Will fail if the image is currently in use by an active deployment.
  */
 const deleteImage = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -386,8 +399,8 @@ const deleteImage = (options) => {
 };
 exports.deleteImage = deleteImage;
 /**
- * Get image by name
- * Returns an image by name.
+ * Get container image
+ * Returns detailed information about a container image including all available tags, creation dates, and size information.
  */
 const getImage = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -403,8 +416,8 @@ const getImage = (options) => {
 };
 exports.getImage = getImage;
 /**
- * Delete image tag
- * Deletes a specific tag from an image.
+ * Delete container image tag
+ * Deletes a specific tag from a container image. The underlying image layers are kept if other tags reference them. Will fail if the tag is currently in use.
  */
 const deleteImageTag = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -420,8 +433,8 @@ const deleteImageTag = (options) => {
 };
 exports.deleteImageTag = deleteImageTag;
 /**
- * List integrations connections
- * Returns integration information by name.
+ * Get integration provider info
+ * Returns metadata about an integration provider including available endpoints, authentication methods, and supported models or features.
  */
 const getIntegration = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -437,8 +450,8 @@ const getIntegration = (options) => {
 };
 exports.getIntegration = getIntegration;
 /**
- * List integrations connections
- * Returns a list of all connections integrations in the workspace.
+ * List integration connections
+ * Returns all configured integration connections in the workspace. Each connection stores credentials and settings for an external service (LLM provider, API, database).
  */
 const listIntegrationConnections = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -454,8 +467,8 @@ const listIntegrationConnections = (options) => {
 };
 exports.listIntegrationConnections = listIntegrationConnections;
 /**
- * Create integration
- * Create a connection for an integration.
+ * Create integration connection
+ * Creates a new integration connection with credentials for an external service. The connection can then be used by models, functions, and other resources to authenticate with the service.
  */
 const createIntegrationConnection = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -475,8 +488,8 @@ const createIntegrationConnection = (options) => {
 };
 exports.createIntegrationConnection = createIntegrationConnection;
 /**
- * Delete integration
- * Deletes an integration connection by integration name and connection name.
+ * Delete integration connection
+ * Permanently deletes an integration connection. Any resources using this connection will lose access to the external service.
  */
 const deleteIntegrationConnection = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -492,8 +505,8 @@ const deleteIntegrationConnection = (options) => {
 };
 exports.deleteIntegrationConnection = deleteIntegrationConnection;
 /**
- * Get integration
- * Returns an integration connection by integration name and connection name.
+ * Get integration connection
+ * Returns detailed information about an integration connection including its provider type, configuration (secrets are masked), and usage status.
  */
 const getIntegrationConnection = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -510,7 +523,7 @@ const getIntegrationConnection = (options) => {
 exports.getIntegrationConnection = getIntegrationConnection;
 /**
  * Update integration connection
- * Update an integration connection by integration name and connection name.
+ * Updates an integration connection's configuration or credentials. Changes take effect immediately for all resources using this connection.
  */
 const updateIntegrationConnection = (options) => {
     return (options.client ?? client_gen_1.client).put({
@@ -564,7 +577,7 @@ const listIntegrationConnectionModels = (options) => {
 };
 exports.listIntegrationConnectionModels = listIntegrationConnectionModels;
 /**
- * Get integration model endpoint configurations
+ * Get integration connection model
  * Returns a model for an integration connection by ID.
  */
 const getIntegrationConnectionModel = (options) => {
@@ -581,8 +594,8 @@ const getIntegrationConnectionModel = (options) => {
 };
 exports.getIntegrationConnectionModel = getIntegrationConnectionModel;
 /**
- * List jobs
- * Returns a list of all jobs in the workspace.
+ * List batch jobs
+ * Returns all batch job definitions in the workspace. Each job can be triggered to run multiple parallel tasks with configurable concurrency and retry settings.
  */
 const listJobs = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -598,8 +611,8 @@ const listJobs = (options) => {
 };
 exports.listJobs = listJobs;
 /**
- * Create job
- * Creates a job.
+ * Create batch job
+ * Creates a new batch job definition for parallel AI task processing. Jobs can be triggered via API or scheduled, and support configurable parallelism, timeouts, and retry logic.
  */
 const createJob = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -619,8 +632,8 @@ const createJob = (options) => {
 };
 exports.createJob = createJob;
 /**
- * Delete job
- * Deletes a job by name.
+ * Delete batch job
+ * Permanently deletes a batch job definition and cancels any running executions. Historical execution data will be retained for a limited time.
  */
 const deleteJob = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -636,8 +649,8 @@ const deleteJob = (options) => {
 };
 exports.deleteJob = deleteJob;
 /**
- * Get job
- * Returns a job by name.
+ * Get batch job
+ * Returns detailed information about a batch job including its runtime configuration, execution history, and deployment status.
  */
 const getJob = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -653,8 +666,8 @@ const getJob = (options) => {
 };
 exports.getJob = getJob;
 /**
- * Create or update job
- * Update a job by name.
+ * Update batch job
+ * Updates a batch job's configuration. Changes affect new executions; running executions continue with their original configuration.
  */
 const updateJob = (options) => {
     return (options.client ?? client_gen_1.client).put({
@@ -675,7 +688,7 @@ const updateJob = (options) => {
 exports.updateJob = updateJob;
 /**
  * List job executions
- * Returns a list of all executions for a job by name.
+ * Returns paginated list of executions for a batch job, sorted by creation time. Each execution contains status, task counts, and timing information.
  */
 const listJobExecutions = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -692,7 +705,7 @@ const listJobExecutions = (options) => {
 exports.listJobExecutions = listJobExecutions;
 /**
  * Create job execution
- * Creates a new execution for a job by name.
+ * Triggers a new execution of the batch job. Each execution runs multiple tasks in parallel according to the job's configured concurrency. Tasks can be parameterized via the request body.
  */
 const createJobExecution = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -712,8 +725,8 @@ const createJobExecution = (options) => {
 };
 exports.createJobExecution = createJobExecution;
 /**
- * Delete job execution
- * Stop an execution for a job by name.
+ * Cancel job execution
+ * Cancels a running job execution. Tasks already in progress will complete, but no new tasks will be started. The execution status changes to 'cancelling' then 'cancelled'.
  */
 const deleteJobExecution = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -730,7 +743,7 @@ const deleteJobExecution = (options) => {
 exports.deleteJobExecution = deleteJobExecution;
 /**
  * Get job execution
- * Returns an execution for a job by name.
+ * Returns detailed information about a specific job execution including status, task statistics (success/failure/running counts), and timing information.
  */
 const getJobExecution = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -763,8 +776,8 @@ const listJobRevisions = (options) => {
 };
 exports.listJobRevisions = listJobRevisions;
 /**
- * List locations
- * Returns a list of all locations available with status.
+ * List deployment regions
+ * Returns all deployment regions with their current availability status and supported hardware flavors. Use this to discover where resources can be deployed.
  */
 const listLocations = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -779,6 +792,10 @@ const listLocations = (options) => {
     });
 };
 exports.listLocations = listLocations;
+/**
+ * List MCP Hub servers
+ * Returns all pre-built MCP server definitions available in the Blaxel Hub. These can be deployed directly to your workspace with pre-configured tools and integrations.
+ */
 const listMcpHubDefinitions = (options) => {
     return (options?.client ?? client_gen_1.client).get({
         security: [
@@ -793,8 +810,8 @@ const listMcpHubDefinitions = (options) => {
 };
 exports.listMcpHubDefinitions = listMcpHubDefinitions;
 /**
- * List models
- * Returns a list of all models in the workspace.
+ * List model endpoints
+ * Returns all model gateway endpoints configured in the workspace. Each model represents a proxy to an external LLM provider (OpenAI, Anthropic, etc.) with unified access control.
  */
 const listModels = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -810,8 +827,8 @@ const listModels = (options) => {
 };
 exports.listModels = listModels;
 /**
- * Create model
- * Creates a model.
+ * Create model endpoint
+ * Creates a new model gateway endpoint that proxies requests to an external LLM provider. Requires an integration connection with valid API credentials for the target provider.
  */
 const createModel = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -831,8 +848,8 @@ const createModel = (options) => {
 };
 exports.createModel = createModel;
 /**
- * Delete model
- * Deletes a model by name.
+ * Delete model endpoint
+ * Permanently deletes a model gateway endpoint. Any agents or applications using this endpoint will need to be updated to use a different model.
  */
 const deleteModel = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -848,8 +865,8 @@ const deleteModel = (options) => {
 };
 exports.deleteModel = deleteModel;
 /**
- * Get model
- * Returns a model by name.
+ * Get model endpoint
+ * Returns detailed information about a model gateway endpoint including its provider configuration, integration connection, and usage status.
  */
 const getModel = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -865,8 +882,8 @@ const getModel = (options) => {
 };
 exports.getModel = getModel;
 /**
- * Create or update model
- * Update a model by name.
+ * Update model endpoint
+ * Updates a model gateway endpoint's configuration. Changes to provider settings or integration connection take effect immediately.
  */
 const updateModel = (options) => {
     return (options.client ?? client_gen_1.client).put({
@@ -903,8 +920,8 @@ const listModelRevisions = (options) => {
 };
 exports.listModelRevisions = listModelRevisions;
 /**
- * List policies
- * Returns a list of all policies in the workspace.
+ * List governance policies
+ * Returns all governance policies in the workspace. Policies control deployment locations, hardware flavors, and token limits for agents, functions, and models.
  */
 const listPolicies = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -920,8 +937,8 @@ const listPolicies = (options) => {
 };
 exports.listPolicies = listPolicies;
 /**
- * Create policy
- * Creates a policy.
+ * Create governance policy
+ * Creates a new governance policy to control where and how resources are deployed. Policies can restrict deployment to specific regions, countries, or continents for compliance.
  */
 const createPolicy = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -941,8 +958,8 @@ const createPolicy = (options) => {
 };
 exports.createPolicy = createPolicy;
 /**
- * Delete policy
- * Deletes a policy by name.
+ * Delete governance policy
+ * Permanently deletes a governance policy. Resources using this policy will need to be updated to use a different policy.
  */
 const deletePolicy = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -958,8 +975,8 @@ const deletePolicy = (options) => {
 };
 exports.deletePolicy = deletePolicy;
 /**
- * Get policy
- * Returns a policy by name.
+ * Get governance policy
+ * Returns detailed information about a governance policy including its type (location, flavor, or maxToken), restrictions, and which resource types it applies to.
  */
 const getPolicy = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -975,8 +992,8 @@ const getPolicy = (options) => {
 };
 exports.getPolicy = getPolicy;
 /**
- * Update policy
- * Updates a policy.
+ * Update governance policy
+ * Updates a governance policy's restrictions. Changes take effect on the next deployment of resources using this policy.
  */
 const updatePolicy = (options) => {
     return (options.client ?? client_gen_1.client).put({
@@ -1029,6 +1046,10 @@ const listPublicIps = (options) => {
     });
 };
 exports.listPublicIps = listPublicIps;
+/**
+ * List Sandbox Hub templates
+ * Returns all pre-built sandbox templates available in the Blaxel Hub. These include popular development environments with pre-installed tools and frameworks.
+ */
 const listSandboxHubDefinitions = (options) => {
     return (options?.client ?? client_gen_1.client).get({
         security: [
@@ -1043,8 +1064,8 @@ const listSandboxHubDefinitions = (options) => {
 };
 exports.listSandboxHubDefinitions = listSandboxHubDefinitions;
 /**
- * List Sandboxes
- * Returns a list of all Sandboxes in the workspace.
+ * List sandboxes
+ * Returns all sandboxes in the workspace. Each sandbox includes its configuration, status, and endpoint URL.
  */
 const listSandboxes = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -1060,8 +1081,8 @@ const listSandboxes = (options) => {
 };
 exports.listSandboxes = listSandboxes;
 /**
- * Create Sandbox
- * Creates a Sandbox.
+ * Create sandbox
+ * Creates a new sandbox VM for secure AI code execution. Sandboxes automatically scale to zero when idle and resume instantly, preserving memory state including running processes and filesystem.
  */
 const createSandbox = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -1081,8 +1102,8 @@ const createSandbox = (options) => {
 };
 exports.createSandbox = createSandbox;
 /**
- * Delete Sandbox
- * Deletes a Sandbox by name.
+ * Delete sandbox
+ * Permanently deletes a sandbox and all its data. If no volumes are attached, this guarantees zero data retention (ZDR). This action cannot be undone.
  */
 const deleteSandbox = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -1098,8 +1119,8 @@ const deleteSandbox = (options) => {
 };
 exports.deleteSandbox = deleteSandbox;
 /**
- * Get Sandbox
- * Returns a Sandbox by name.
+ * Get sandbox
+ * Returns detailed information about a sandbox including its configuration, attached volumes, lifecycle policies, and API endpoint URL.
  */
 const getSandbox = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -1115,8 +1136,8 @@ const getSandbox = (options) => {
 };
 exports.getSandbox = getSandbox;
 /**
- * Update Sandbox
- * Update a Sandbox by name.
+ * Update sandbox
+ * Updates a sandbox's configuration. Note that certain changes (like image or memory) may reset the sandbox state. Use lifecycle policies to control automatic cleanup.
  */
 const updateSandbox = (options) => {
     return (options.client ?? client_gen_1.client).put({
@@ -1284,42 +1305,8 @@ const deleteSandboxPreviewToken = (options) => {
 };
 exports.deleteSandboxPreviewToken = deleteSandboxPreviewToken;
 /**
- * Start Sandbox
- * Starts a Sandbox by name.
- */
-const startSandbox = (options) => {
-    return (options.client ?? client_gen_1.client).put({
-        security: [
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/sandboxes/{sandboxName}/start',
-        ...options
-    });
-};
-exports.startSandbox = startSandbox;
-/**
- * Stop Sandbox
- * Stops a Sandbox by name.
- */
-const stopSandbox = (options) => {
-    return (options.client ?? client_gen_1.client).put({
-        security: [
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/sandboxes/{sandboxName}/stop',
-        ...options
-    });
-};
-exports.stopSandbox = stopSandbox;
-/**
- * Get workspace service accounts
- * Returns a list of all service accounts in the workspace.
+ * List service accounts
+ * Returns all service accounts in the workspace. Service accounts are machine identities for external systems to authenticate with Blaxel via OAuth or API keys.
  */
 const getWorkspaceServiceAccounts = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -1335,8 +1322,8 @@ const getWorkspaceServiceAccounts = (options) => {
 };
 exports.getWorkspaceServiceAccounts = getWorkspaceServiceAccounts;
 /**
- * Create workspace service account
- * Creates a service account in the workspace.
+ * Create service account
+ * Creates a new service account for machine-to-machine authentication. Returns client ID and secret (secret is only shown once at creation). Use these credentials for OAuth client_credentials flow.
  */
 const createWorkspaceServiceAccount = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -1356,8 +1343,8 @@ const createWorkspaceServiceAccount = (options) => {
 };
 exports.createWorkspaceServiceAccount = createWorkspaceServiceAccount;
 /**
- * Delete workspace service account
- * Deletes a service account.
+ * Delete service account
+ * Permanently deletes a service account and invalidates all its credentials. Any systems using this service account will lose access immediately.
  */
 const deleteWorkspaceServiceAccount = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -1373,8 +1360,8 @@ const deleteWorkspaceServiceAccount = (options) => {
 };
 exports.deleteWorkspaceServiceAccount = deleteWorkspaceServiceAccount;
 /**
- * Update workspace service account
- * Updates a service account.
+ * Update service account
+ * Updates a service account's name or description. Credentials (client ID/secret) cannot be changed.
  */
 const updateWorkspaceServiceAccount = (options) => {
     return (options.client ?? client_gen_1.client).put({
@@ -1394,8 +1381,8 @@ const updateWorkspaceServiceAccount = (options) => {
 };
 exports.updateWorkspaceServiceAccount = updateWorkspaceServiceAccount;
 /**
- * List API keys for service account
- * Returns a list of all API keys for a service account.
+ * List service account API keys
+ * Returns all long-lived API keys created for a service account. API keys provide an alternative to OAuth for simpler authentication scenarios.
  */
 const listApiKeysForServiceAccount = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -1411,8 +1398,8 @@ const listApiKeysForServiceAccount = (options) => {
 };
 exports.listApiKeysForServiceAccount = listApiKeysForServiceAccount;
 /**
- * Create API key for service account
- * Creates an API key for a service account.
+ * Create service account API key
+ * Creates a new long-lived API key for a service account. The full key value is only returned once at creation. API keys can have optional expiration dates.
  */
 const createApiKeyForServiceAccount = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -1432,8 +1419,8 @@ const createApiKeyForServiceAccount = (options) => {
 };
 exports.createApiKeyForServiceAccount = createApiKeyForServiceAccount;
 /**
- * Delete API key for service account
- * Deletes an API key for a service account.
+ * Revoke service account API key
+ * Revokes an API key for a service account. The key becomes invalid immediately and any requests using it will fail authentication.
  */
 const deleteApiKeyForServiceAccount = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -1449,8 +1436,8 @@ const deleteApiKeyForServiceAccount = (options) => {
 };
 exports.deleteApiKeyForServiceAccount = deleteApiKeyForServiceAccount;
 /**
- * List templates
- * Returns a list of all templates.
+ * List deployment templates
+ * Returns all deployment templates available for creating agents, functions, and other resources with pre-configured settings and code.
  */
 const listTemplates = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -1467,7 +1454,7 @@ const listTemplates = (options) => {
 exports.listTemplates = listTemplates;
 /**
  * Get template
- * Returns a template by name.
+ * Returns detailed information about a deployment template including its configuration, source code reference, and available parameters.
  */
 const getTemplate = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -1483,8 +1470,8 @@ const getTemplate = (options) => {
 };
 exports.getTemplate = getTemplate;
 /**
- * List users in workspace
- * Returns a list of all users in the workspace.
+ * List workspace team members
+ * Returns all team members in the workspace including their roles (admin or member) and invitation status.
  */
 const listWorkspaceUsers = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -1501,7 +1488,7 @@ const listWorkspaceUsers = (options) => {
 exports.listWorkspaceUsers = listWorkspaceUsers;
 /**
  * Invite user to workspace
- * Invites a user to the workspace by email.
+ * Invites a new team member to the workspace by email. The invitee will receive an email to accept the invitation before gaining access to workspace resources.
  */
 const inviteWorkspaceUser = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -1560,7 +1547,7 @@ const updateWorkspaceUserRole = (options) => {
 exports.updateWorkspaceUserRole = updateWorkspaceUserRole;
 /**
  * List volume templates
- * Returns a list of all volume templates.
+ * Returns all volume templates in the workspace. Volume templates contain pre-configured filesystem snapshots that can be used to initialize new volumes.
  */
 const listVolumeTemplates = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -1577,7 +1564,7 @@ const listVolumeTemplates = (options) => {
 exports.listVolumeTemplates = listVolumeTemplates;
 /**
  * Create volume template
- * Creates a volume template.
+ * Creates a new volume template for initializing volumes with pre-configured filesystem contents. Optionally returns a presigned URL for uploading the template archive.
  */
 const createVolumeTemplate = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -1669,8 +1656,8 @@ const deleteVolumeTemplateVersion = (options) => {
 };
 exports.deleteVolumeTemplateVersion = deleteVolumeTemplateVersion;
 /**
- * List volumes
- * Returns a list of all volumes in the workspace.
+ * List persistent volumes
+ * Returns all persistent storage volumes in the workspace. Volumes can be attached to sandboxes for durable file storage that persists across sessions and sandbox deletions.
  */
 const listVolumes = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -1686,8 +1673,8 @@ const listVolumes = (options) => {
 };
 exports.listVolumes = listVolumes;
 /**
- * Create volume
- * Creates a volume.
+ * Create persistent volume
+ * Creates a new persistent storage volume that can be attached to sandboxes. Volumes must be created in a specific region and can only attach to sandboxes in the same region.
  */
 const createVolume = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -1707,8 +1694,8 @@ const createVolume = (options) => {
 };
 exports.createVolume = createVolume;
 /**
- * Delete volume
- * Deletes a volume by name.
+ * Delete persistent volume
+ * Permanently deletes a volume and all its data. The volume must not be attached to any sandbox. This action cannot be undone.
  */
 const deleteVolume = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -1724,8 +1711,8 @@ const deleteVolume = (options) => {
 };
 exports.deleteVolume = deleteVolume;
 /**
- * Get volume
- * Returns a volume by name.
+ * Get persistent volume
+ * Returns detailed information about a volume including its size, region, attachment status, and any events history.
  */
 const getVolume = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -1741,8 +1728,8 @@ const getVolume = (options) => {
 };
 exports.getVolume = getVolume;
 /**
- * List workspaces
- * Returns a list of all workspaces.
+ * List accessible workspaces
+ * Returns all workspaces the authenticated user has access to. Each workspace is a separate tenant with its own resources, team members, and billing.
  */
 const listWorkspaces = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -1758,8 +1745,8 @@ const listWorkspaces = (options) => {
 };
 exports.listWorkspaces = listWorkspaces;
 /**
- * Create worspace
- * Creates a workspace.
+ * Create workspace tenant
+ * Creates a new workspace tenant. The authenticated user becomes the workspace admin. Requires a linked billing account.
  */
 const createWorkspace = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -1779,8 +1766,8 @@ const createWorkspace = (options) => {
 };
 exports.createWorkspace = createWorkspace;
 /**
- * Delete workspace
- * Deletes a workspace by name.
+ * Delete workspace tenant
+ * Permanently deletes a workspace and ALL its resources (agents, functions, sandboxes, volumes, etc.). This action cannot be undone. Only workspace admins can delete a workspace.
  */
 const deleteWorkspace = (options) => {
     return (options.client ?? client_gen_1.client).delete({
@@ -1796,8 +1783,8 @@ const deleteWorkspace = (options) => {
 };
 exports.deleteWorkspace = deleteWorkspace;
 /**
- * Get workspace
- * Returns a workspace by name.
+ * Get workspace details
+ * Returns detailed information about a workspace including its display name, account ID, status, and runtime configuration.
  */
 const getWorkspace = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -1814,7 +1801,7 @@ const getWorkspace = (options) => {
 exports.getWorkspace = getWorkspace;
 /**
  * Update workspace
- * Updates a workspace by name.
+ * Updates a workspace's settings such as display name and labels. The workspace name cannot be changed after creation.
  */
 const updateWorkspace = (options) => {
     return (options.client ?? client_gen_1.client).put({