@blaxel/core 0.2.89 → 0.2.90-dev.181

package/dist/cjs-browser/types/client/types.gen.d.ts

@@ -16,6 +16,26 @@ export type AgentWritable = {
     spec: AgentSpecWritable;
     status?: Status;
 };
+/**
+ * Cursor-paginated list of agents. Returned starting with API version 2026-04-28; older API versions return a bare array of agents instead.
+ */
+export type AgentList = {
+    /**
+     * Page of agents.
+     */
+    data?: Array<Agent>;
+    meta?: PaginationMeta;
+};
+/**
+ * Cursor-paginated list of agents. Returned starting with API version 2026-04-28; older API versions return a bare array of agents instead.
+ */
+export type AgentListWritable = {
+    /**
+     * Page of agents.
+     */
+    data?: Array<AgentWritable>;
+    meta?: PaginationMeta;
+};
 /**
  * Runtime configuration defining how the AI agent is deployed and scaled globally
  */
@@ -149,6 +169,10 @@ export type Configuration = {
      * Countries
      */
     countries?: Array<Country>;
+    /**
+     * Auto-detected closest region based on viewer geolocation (from CloudFront headers). Empty when geo headers are not available.
+     */
+    detectedRegion?: string;
     /**
      * Private locations managed with blaxel operator
      */
@@ -446,6 +470,26 @@ export type DriveWritable = {
     spec: DriveSpecWritable;
     state?: DriveStateWritable;
 };
+/**
+ * Cursor-paginated list of drives. Returned starting with API version 2026-04-28; older API versions return a bare array.
+ */
+export type DriveList = {
+    /**
+     * Page of drives.
+     */
+    data?: Array<Drive>;
+    meta?: PaginationMeta;
+};
+/**
+ * Cursor-paginated list of drives. Returned starting with API version 2026-04-28; older API versions return a bare array.
+ */
+export type DriveListWritable = {
+    /**
+     * Page of drives.
+     */
+    data?: Array<DriveWritable>;
+    meta?: PaginationMeta;
+};
 /**
  * Immutable drive configuration set at creation time
  */
@@ -563,6 +607,12 @@ export type EgressGatewaySpec = {
      */
     region: string;
 };
+/**
+ * Sandboxes currently bound to each egress gateway. Returned by GET /egressgateways/usage so the egress-IPs UI can render attachment counts without fetching the sandboxes listing full. Keys are gateway names; values are sandbox names.
+ */
+export type EgressGatewayUsage = {
+    [key: string]: Array<string>;
+};
 /**
  * An individual IP address allocated from an egress gateway for dedicated outbound traffic
  */
@@ -789,6 +839,26 @@ export type FunctionWritable = {
     spec: FunctionSpecWritable;
     status?: Status;
 };
+/**
+ * Cursor-paginated list of MCP server functions. Returned starting with API version 2026-04-28; older API versions return a bare array.
+ */
+export type FunctionList = {
+    /**
+     * Page of functions.
+     */
+    data?: Array<_Function>;
+    meta?: PaginationMeta;
+};
+/**
+ * Cursor-paginated list of MCP server functions. Returned starting with API version 2026-04-28; older API versions return a bare array.
+ */
+export type FunctionListWritable = {
+    /**
+     * Page of functions.
+     */
+    data?: Array<FunctionWritable>;
+    meta?: PaginationMeta;
+};
 /**
  * Runtime configuration defining how the MCP server function is deployed and scaled
  */
@@ -1236,6 +1306,26 @@ export type JobExecutionWritable = {
      */
     tasks?: Array<JobExecutionTaskWritable>;
 };
+/**
+ * Cursor-paginated list of job executions. Returned starting with API version 2026-04-28; older API versions keep the legacy offset-based contract and return a bare array.
+ */
+export type JobExecutionList = {
+    /**
+     * Page of job executions.
+     */
+    data?: Array<JobExecution>;
+    meta?: PaginationMeta;
+};
+/**
+ * Cursor-paginated list of job executions. Returned starting with API version 2026-04-28; older API versions keep the legacy offset-based contract and return a bare array.
+ */
+export type JobExecutionListWritable = {
+    /**
+     * Page of job executions.
+     */
+    data?: Array<JobExecutionWritable>;
+    meta?: PaginationMeta;
+};
 /**
  * Job execution metadata
  */
@@ -1495,6 +1585,26 @@ export type JobExecutionTaskCondition = {
      */
     type?: string;
 };
+/**
+ * Cursor-paginated list of an execution's tasks. Tasks are derived from event history; pagination slices the in-memory list and the cursor is a base64-JSON offset bound to (workspace, job, execution).
+ */
+export type JobExecutionTaskList = {
+    /**
+     * Page of execution tasks.
+     */
+    data?: Array<JobExecutionTask>;
+    meta?: PaginationMeta;
+};
+/**
+ * Cursor-paginated list of an execution's tasks. Tasks are derived from event history; pagination slices the in-memory list and the cursor is a base64-JSON offset bound to (workspace, job, execution).
+ */
+export type JobExecutionTaskListWritable = {
+    /**
+     * Page of execution tasks.
+     */
+    data?: Array<JobExecutionTaskWritable>;
+    meta?: PaginationMeta;
+};
 /**
  * Job execution task metadata
  */
@@ -1550,6 +1660,26 @@ export type JobExecutionTaskSpec = {
  * Job execution task status
  */
 export type JobExecutionTaskStatus = 'unspecified' | 'pending' | 'reconciling' | 'failed' | 'succeeded' | 'running' | 'cancelled';
+/**
+ * Cursor-paginated list of batch jobs. Returned starting with API version 2026-04-28; older API versions return a bare array.
+ */
+export type JobList = {
+    /**
+     * Page of jobs.
+     */
+    data?: Array<Job>;
+    meta?: PaginationMeta;
+};
+/**
+ * Cursor-paginated list of batch jobs. Returned starting with API version 2026-04-28; older API versions return a bare array.
+ */
+export type JobListWritable = {
+    /**
+     * Page of jobs.
+     */
+    data?: Array<JobWritable>;
+    meta?: PaginationMeta;
+};
 /**
  * Runtime configuration defining how batch job tasks are executed with parallelism and retry settings
  */
@@ -1648,6 +1778,60 @@ export type JobVolume = {
     type: 'ephemeral';
 };
 export type JobVolumes = Array<JobVolume>;
+/**
+ * LiteVolume is the listing-shape projection of a Volume. Drops events to keep page payloads small.
+ */
+export type LiteVolume = {
+    metadata?: LiteVolumeMetadata;
+    spec?: LiteVolumeSpec;
+    state?: VolumeState;
+    /**
+     * Computed status of the volume.
+     */
+    status?: string;
+    /**
+     * Termination timestamp for soft-deleted volumes.
+     */
+    terminatedAt?: string;
+};
+/**
+ * LiteVolume is the listing-shape projection of a Volume. Drops events to keep page payloads small.
+ */
+export type LiteVolumeWritable = {
+    metadata?: LiteVolumeMetadata;
+    spec?: LiteVolumeSpec;
+    state?: VolumeStateWritable;
+    /**
+     * Computed status of the volume.
+     */
+    status?: string;
+    /**
+     * Termination timestamp for soft-deleted volumes.
+     */
+    terminatedAt?: string;
+};
+/**
+ * Compact metadata for a Volume, returned in listing responses.
+ */
+export type LiteVolumeMetadata = {
+    createdAt?: string;
+    displayName?: string;
+    name?: string;
+    updatedAt?: string;
+};
+/**
+ * Compact spec for a Volume, returned in listing responses.
+ */
+export type LiteVolumeSpec = {
+    /**
+     * Region the volume is provisioned in.
+     */
+    region?: string;
+    /**
+     * Volume size in gigabytes.
+     */
+    size?: number;
+};
 /**
  * Location availability for policies
  */
@@ -1871,6 +2055,26 @@ export type ModelWritable = {
     spec: ModelSpec;
     status?: Status;
 };
+/**
+ * Cursor-paginated list of model gateway endpoints. Returned starting with API version 2026-04-28; older API versions return a bare array.
+ */
+export type ModelList = {
+    /**
+     * Page of models.
+     */
+    data?: Array<Model>;
+    meta?: PaginationMeta;
+};
+/**
+ * Cursor-paginated list of model gateway endpoints. Returned starting with API version 2026-04-28; older API versions return a bare array.
+ */
+export type ModelListWritable = {
+    /**
+     * Page of models.
+     */
+    data?: Array<ModelWritable>;
+    meta?: PaginationMeta;
+};
 /**
  * Configuration identifying which external LLM provider and model this gateway endpoint proxies to
  */
@@ -1950,6 +2154,23 @@ export type OwnerFields = {
      */
     readonly updatedBy?: string;
 };
+/**
+ * Pagination metadata returned alongside a page of listing results. Always present on listing endpoints starting with API version 2026-04-28.
+ */
+export type PaginationMeta = {
+    /**
+     * True when more pages are available beyond the current one.
+     */
+    hasMore?: boolean;
+    /**
+     * Opaque cursor to pass back as the `cursor` query param for the next page. Empty when there are no more pages.
+     */
+    nextCursor?: string;
+    /**
+     * Total number of items in the workspace, ignoring the current page's filters. Lets the UI render "page X of Y" without walking the cursor chain. Computed from the hash-only metadata.workspace GSI count, so search (`q`) does not narrow it.
+     */
+    total?: number;
+};
 /**
  * Pending cross-account image share awaiting approval from the destination workspace
  */
@@ -2261,6 +2482,7 @@ export type PoliciesList = Array<string>;
 export type Policy = {
     metadata: Metadata;
     spec: PolicySpec;
+    usage?: PolicyUsageCounts;
 };
 /**
  * Rule that controls how a deployment is made and served (e.g. location restrictions)
@@ -2268,6 +2490,27 @@ export type Policy = {
 export type PolicyWritable = {
     metadata: MetadataWritable;
     spec: PolicySpec;
+    usage?: PolicyUsageCounts;
+};
+/**
+ * Cursor-paginated list of policies. Returned starting with API version 2026-04-28; older API versions return a bare array.
+ */
+export type PolicyList = {
+    /**
+     * Page of policies.
+     */
+    data?: Array<Policy>;
+    meta?: PaginationMeta;
+};
+/**
+ * Cursor-paginated list of policies. Returned starting with API version 2026-04-28; older API versions return a bare array.
+ */
+export type PolicyListWritable = {
+    /**
+     * Page of policies.
+     */
+    data?: Array<PolicyWritable>;
+    meta?: PaginationMeta;
 };
 /**
  * Policy location
@@ -2340,6 +2583,51 @@ export type PolicySpec = {
      */
     type?: 'location' | 'flavor' | 'maxToken';
 };
+/**
+ * Per-resource counts of how many resources reference a policy. Computed by the policies listing endpoint to avoid client-side fan-out across the agents/models/functions/sandboxes/jobs listings.
+ */
+export type PolicyUsageCounts = {
+    agents?: number;
+    functions?: number;
+    jobs?: number;
+    models?: number;
+    sandboxes?: number;
+};
+/**
+ * Resources currently referencing a policy. Returned by GET /policies/{name}/usages so the policies UI can render attachments without fetching the agents/models/functions listings full.
+ */
+export type PolicyUsages = {
+    /**
+     * Names of agents whose spec.policies contains this policy.
+     */
+    agents?: Array<{
+        [key: string]: unknown;
+    }>;
+    /**
+     * Names of functions whose spec.policies contains this policy.
+     */
+    functions?: Array<{
+        [key: string]: unknown;
+    }>;
+    /**
+     * Names of jobs whose spec.policies contains this policy.
+     */
+    jobs?: Array<{
+        [key: string]: unknown;
+    }>;
+    /**
+     * Names of models whose spec.policies contains this policy.
+     */
+    models?: Array<{
+        [key: string]: unknown;
+    }>;
+    /**
+     * Names of sandboxes whose spec.policies contains this policy.
+     */
+    sandboxes?: Array<{
+        [key: string]: unknown;
+    }>;
+};
 /**
  * A port for a resource
  */
@@ -3051,6 +3339,26 @@ export type SandboxLifecycle = {
      */
     terminatedRetention?: string;
 };
+/**
+ * Cursor-paginated list of sandboxes. Returned starting with API version 2026-04-28; older API versions return a bare array.
+ */
+export type SandboxList = {
+    /**
+     * Page of sandboxes. Items use the lite shape (no inline event history) to keep the page payload small, matching the unpaginated response.
+     */
+    data?: Array<Sandbox>;
+    meta?: PaginationMeta;
+};
+/**
+ * Cursor-paginated list of sandboxes. Returned starting with API version 2026-04-28; older API versions return a bare array.
+ */
+export type SandboxListWritable = {
+    /**
+     * Page of sandboxes. Items use the lite shape (no inline event history) to keep the page payload small, matching the unpaginated response.
+     */
+    data?: Array<SandboxWritable>;
+    meta?: PaginationMeta;
+};
 /**
  * Network configuration for a sandbox including domain filtering, egress IP binding, and proxy settings
  */
@@ -3224,7 +3532,7 @@ export type Trigger = {
      */
     enabled?: boolean;
     /**
-     * The id of the trigger
+     * Identifier of the trigger. Optional — the server auto-generates a unique id when one is not provided, and disambiguates duplicates within a resource.
      */
     id?: string;
     /**
@@ -3242,7 +3550,7 @@ export type TriggerWritable = {
      */
     enabled?: boolean;
     /**
-     * The id of the trigger
+     * Identifier of the trigger. Optional — the server auto-generates a unique id when one is not provided, and disambiguates duplicates within a resource.
      */
     id?: string;
     /**
@@ -3402,6 +3710,26 @@ export type VolumeAttachment = {
     readOnly?: boolean;
 };
 export type VolumeAttachments = Array<VolumeAttachment>;
+/**
+ * Cursor-paginated list of volumes. Returned starting with API version 2026-04-28; older API versions return a bare array. Items use the lite shape (no inline event history).
+ */
+export type VolumeList = {
+    /**
+     * Page of volumes.
+     */
+    data?: Array<LiteVolume>;
+    meta?: PaginationMeta;
+};
+/**
+ * Cursor-paginated list of volumes. Returned starting with API version 2026-04-28; older API versions return a bare array. Items use the lite shape (no inline event history).
+ */
+export type VolumeListWritable = {
+    /**
+     * Page of volumes.
+     */
+    data?: Array<LiteVolumeWritable>;
+    meta?: PaginationMeta;
+};
 /**
  * Immutable volume configuration set at creation time (size and region cannot be changed after creation)
  */
@@ -3608,6 +3936,12 @@ export type Workspace = TimeFields & OwnerFields & {
      * Workspace write region
      */
     region?: string;
+    /**
+     * Per-resource counts (agents, functions, models, sandboxes, policies, jobs, volumes, drives, volumetemplates, integrationconnections, previews, customdomains, serviceaccounts, images). Only populated when GetWorkspace is called with ?countResources=true.
+     */
+    readonly resourceCounts?: {
+        [key: string]: number;
+    };
     runtime?: WorkspaceRuntime;
     /**
      * Workspace status (created, account_binded, account_configured, workspace_configured, ready, error)
@@ -3666,6 +4000,52 @@ export type WorkspaceAvailability = {
      */
     reason?: 'taken' | 'forbidden_reserved' | 'forbidden_blaxel' | 'forbidden_v_prefix';
 };
+/**
+ * HIPAA compliance state for a workspace. `accountEnabled` mirrors the account-level `hipaa_compliance` addon (set server-side from operator tooling and Stripe billing events). `unsafe` records a per-workspace opt-out toggled from workspace settings; absent when the account does not have the addon.
+ */
+export type WorkspaceHipaaInfo = {
+    /**
+     * True when the parent account has the HIPAA compliance addon active. Set server-side from operator tooling and Stripe billing events; cannot be changed from workspace settings.
+     */
+    accountEnabled?: boolean;
+    unsafe?: WorkspaceHipaaUnsafe;
+};
+/**
+ * HIPAA compliance state for a workspace. `accountEnabled` mirrors the account-level `hipaa_compliance` addon (set server-side from operator tooling and Stripe billing events). `unsafe` records a per-workspace opt-out toggled from workspace settings; absent when the account does not have the addon.
+ */
+export type WorkspaceHipaaInfoWritable = {
+    /**
+     * True when the parent account has the HIPAA compliance addon active. Set server-side from operator tooling and Stripe billing events; cannot be changed from workspace settings.
+     */
+    accountEnabled?: boolean;
+    unsafe?: WorkspaceHipaaUnsafeWritable;
+};
+/**
+ * Per-workspace HIPAA opt-out record. Toggled from workspace settings; the backend stamps `updatedBy` and `updatedAt`.
+ */
+export type WorkspaceHipaaUnsafe = {
+    /**
+     * True marks this workspace as HIPAA-unsafe (NOT compliant), overriding the account-level addon. False marks the workspace as HIPAA compliant.
+     */
+    enabled?: boolean;
+    /**
+     * RFC3339 timestamp when the opt-out was last toggled. Stamped server-side.
+     */
+    readonly updatedAt?: string;
+    /**
+     * User id (sub) of the actor that last toggled this opt-out. Stamped server-side.
+     */
+    readonly updatedBy?: string;
+};
+/**
+ * Per-workspace HIPAA opt-out record. Toggled from workspace settings; the backend stamps `updatedBy` and `updatedAt`.
+ */
+export type WorkspaceHipaaUnsafeWritable = {
+    /**
+     * True marks this workspace as HIPAA-unsafe (NOT compliant), overriding the account-level addon. False marks the workspace as HIPAA compliant.
+     */
+    enabled?: boolean;
+};
 /**
  * Runtime configuration for the workspace infrastructure
  */
@@ -3716,10 +4096,55 @@ export type WorkspaceUser = {
      */
     sub?: string;
 };
+/**
+ * API version (e.g., 2026-04-16). Defaults to the earliest stable version if omitted. See https://docs.blaxel.ai/api-reference/introduction#api-versioning.
+ */
+export type BlaxelVersion = string;
+/**
+ * Start from a known pagination boundary. `end` is only supported for `createdAt:desc` listings and returns the oldest page directly without walking every cursor from the first page.
+ */
+export type PaginationAnchor = 'end';
+/**
+ * Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.
+ */
+export type PaginationCursor = string;
+/**
+ * Maximum number of items to return per page. Defaults to 50, clamped to 200.
+ */
+export type PaginationLimit = number;
+/**
+ * Substring search across `metadata.name`, `metadata.displayName` and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+ */
+export type PaginationQuery = string;
+/**
+ * Sort spec, formatted as `<key>:<direction>`. Allowed values are `createdAt:desc` (default), `createdAt:asc`, `name:asc`, `name:desc`. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+ */
+export type PaginationSort = 'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc';
 export type ListAgentsData = {
     body?: never;
     path?: never;
-    query?: never;
+    query?: {
+        /**
+         * Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.
+         */
+        cursor?: string;
+        /**
+         * Maximum number of items to return per page. Defaults to 50, clamped to 200.
+         */
+        limit?: number;
+        /**
+         * Sort spec, formatted as `<key>:<direction>`. Allowed values are `createdAt:desc` (default), `createdAt:asc`, `name:asc`, `name:desc`. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        sort?: 'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc';
+        /**
+         * Substring search across `metadata.name`, `metadata.displayName` and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        q?: string;
+        /**
+         * Start from a known pagination boundary. `end` is only supported for `createdAt:desc` listings and returns the oldest page directly without walking every cursor from the first page.
+         */
+        anchor?: 'end';
+    };
     url: '/agents';
 };
 export type ListAgentsErrors = {
@@ -3741,7 +4166,7 @@ export type ListAgentsResponses = {
     /**
      * successful operation
      */
-    200: Array<Agent>;
+    200: AgentList;
 };
 export type ListAgentsResponse = ListAgentsResponses[keyof ListAgentsResponses];
 export type CreateAgentData = {
@@ -4032,7 +4457,28 @@ export type VerifyCustomDomainResponse = VerifyCustomDomainResponses[keyof Verif
 export type ListDrivesData = {
     body?: never;
     path?: never;
-    query?: never;
+    query?: {
+        /**
+         * Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.
+         */
+        cursor?: string;
+        /**
+         * Maximum number of items to return per page. Defaults to 50, clamped to 200.
+         */
+        limit?: number;
+        /**
+         * Sort spec, formatted as `<key>:<direction>`. Allowed values are `createdAt:desc` (default), `createdAt:asc`, `name:asc`, `name:desc`. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        sort?: 'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc';
+        /**
+         * Substring search across `metadata.name`, `metadata.displayName` and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        q?: string;
+        /**
+         * Start from a known pagination boundary. `end` is only supported for `createdAt:desc` listings and returns the oldest page directly without walking every cursor from the first page.
+         */
+        anchor?: 'end';
+    };
     url: '/drives';
 };
 export type ListDrivesErrors = {
@@ -4045,7 +4491,7 @@ export type ListDrivesResponses = {
     /**
      * successful operation
      */
-    200: Array<Drive>;
+    200: DriveList;
 };
 export type ListDrivesResponse = ListDrivesResponses[keyof ListDrivesResponses];
 export type CreateDriveData = {
@@ -4208,6 +4654,19 @@ export type ListAllEgressGatewaysResponses = {
     200: Array<EgressGateway>;
 };
 export type ListAllEgressGatewaysResponse = ListAllEgressGatewaysResponses[keyof ListAllEgressGatewaysResponses];
+export type GetEgressGatewayUsageData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/egressgateways/usage';
+};
+export type GetEgressGatewayUsageResponses = {
+    /**
+     * successful operation
+     */
+    200: EgressGatewayUsage;
+};
+export type GetEgressGatewayUsageResponse = GetEgressGatewayUsageResponses[keyof GetEgressGatewayUsageResponses];
 export type ListAllEgressIpsData = {
     body?: never;
     path?: never;
@@ -4305,7 +4764,28 @@ export type TestFeatureFlagResponse = TestFeatureFlagResponses[keyof TestFeature
 export type ListFunctionsData = {
     body?: never;
     path?: never;
-    query?: never;
+    query?: {
+        /**
+         * Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.
+         */
+        cursor?: string;
+        /**
+         * Maximum number of items to return per page. Defaults to 50, clamped to 200.
+         */
+        limit?: number;
+        /**
+         * Sort spec, formatted as `<key>:<direction>`. Allowed values are `createdAt:desc` (default), `createdAt:asc`, `name:asc`, `name:desc`. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        sort?: 'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc';
+        /**
+         * Substring search across `metadata.name`, `metadata.displayName` and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        q?: string;
+        /**
+         * Start from a known pagination boundary. `end` is only supported for `createdAt:desc` listings and returns the oldest page directly without walking every cursor from the first page.
+         */
+        anchor?: 'end';
+    };
     url: '/functions';
 };
 export type ListFunctionsErrors = {
@@ -4327,7 +4807,7 @@ export type ListFunctionsResponses = {
     /**
      * successful operation
      */
-    200: Array<_Function>;
+    200: FunctionList;
 };
 export type ListFunctionsResponse = ListFunctionsResponses[keyof ListFunctionsResponses];
 export type CreateFunctionData = {
@@ -5050,14 +5530,35 @@ export type GetIntegrationConnectionModelResponses = {
 export type ListJobsData = {
     body?: never;
     path?: never;
-    query?: never;
+    query?: {
+        /**
+         * Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.
+         */
+        cursor?: string;
+        /**
+         * Maximum number of items to return per page. Defaults to 50, clamped to 200.
+         */
+        limit?: number;
+        /**
+         * Sort spec, formatted as `<key>:<direction>`. Allowed values are `createdAt:desc` (default), `createdAt:asc`, `name:asc`, `name:desc`. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        sort?: 'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc';
+        /**
+         * Substring search across `metadata.name`, `metadata.displayName` and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        q?: string;
+        /**
+         * Start from a known pagination boundary. `end` is only supported for `createdAt:desc` listings and returns the oldest page directly without walking every cursor from the first page.
+         */
+        anchor?: 'end';
+    };
     url: '/jobs';
 };
 export type ListJobsResponses = {
     /**
      * successful operation
      */
-    200: Array<Job>;
+    200: JobList;
 };
 export type ListJobsResponse = ListJobsResponses[keyof ListJobsResponses];
 export type CreateJobData = {
@@ -5146,9 +5647,21 @@ export type ListJobExecutionsData = {
          */
         limit?: number;
         /**
-         * Page offset
+         * Page offset (legacy, ignored when Blaxel-Version >= 2026-04-28)
          */
         offset?: number;
+        /**
+         * Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.
+         */
+        cursor?: string;
+        /**
+         * Sort spec, formatted as `<key>:<direction>`. Allowed values are `createdAt:desc` (default), `createdAt:asc`, `name:asc`, `name:desc`. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        sort?: 'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc';
+        /**
+         * Substring search across `metadata.name`, `metadata.displayName` and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        q?: string;
     };
     url: '/jobs/{jobId}/executions';
 };
@@ -5166,7 +5679,7 @@ export type ListJobExecutionsResponses = {
     /**
      * successful operation
      */
-    200: Array<JobExecution>;
+    200: JobExecutionList;
 };
 export type ListJobExecutionsResponse = ListJobExecutionsResponses[keyof ListJobExecutionsResponses];
 export type CreateJobExecutionData = {
@@ -5269,6 +5782,59 @@ export type GetJobExecutionResponses = {
     200: JobExecution;
 };
 export type GetJobExecutionResponse = GetJobExecutionResponses[keyof GetJobExecutionResponses];
+export type ListJobExecutionTasksData = {
+    body?: never;
+    path: {
+        /**
+         * Name of the job
+         */
+        jobId: string;
+        /**
+         * Execution id
+         */
+        executionId: string;
+    };
+    query?: {
+        /**
+         * Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.
+         */
+        cursor?: string;
+        /**
+         * Maximum number of items to return per page. Defaults to 50, clamped to 200.
+         */
+        limit?: number;
+        /**
+         * Sort spec, formatted as `<key>:<direction>`. Allowed values are `createdAt:desc` (default), `createdAt:asc`, `name:asc`, `name:desc`. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        sort?: 'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc';
+        /**
+         * Substring search across `metadata.name`, `metadata.displayName` and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        q?: string;
+    };
+    url: '/jobs/{jobId}/executions/{executionId}/tasks';
+};
+export type ListJobExecutionTasksErrors = {
+    /**
+     * bad request
+     */
+    400: unknown;
+    /**
+     * job or execution not found
+     */
+    404: unknown;
+    /**
+     * internal server error
+     */
+    500: unknown;
+};
+export type ListJobExecutionTasksResponses = {
+    /**
+     * successful operation
+     */
+    200: JobExecutionTaskList;
+};
+export type ListJobExecutionTasksResponse = ListJobExecutionTasksResponses[keyof ListJobExecutionTasksResponses];
 export type ListJobRevisionsData = {
     body?: never;
     path: {
@@ -5316,7 +5882,28 @@ export type ListMcpHubDefinitionsResponse = ListMcpHubDefinitionsResponses[keyof
 export type ListModelsData = {
     body?: never;
     path?: never;
-    query?: never;
+    query?: {
+        /**
+         * Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.
+         */
+        cursor?: string;
+        /**
+         * Maximum number of items to return per page. Defaults to 50, clamped to 200.
+         */
+        limit?: number;
+        /**
+         * Sort spec, formatted as `<key>:<direction>`. Allowed values are `createdAt:desc` (default), `createdAt:asc`, `name:asc`, `name:desc`. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        sort?: 'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc';
+        /**
+         * Substring search across `metadata.name`, `metadata.displayName` and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        q?: string;
+        /**
+         * Start from a known pagination boundary. `end` is only supported for `createdAt:desc` listings and returns the oldest page directly without walking every cursor from the first page.
+         */
+        anchor?: 'end';
+    };
     url: '/models';
 };
 export type ListModelsErrors = {
@@ -5338,7 +5925,7 @@ export type ListModelsResponses = {
     /**
      * successful operation
      */
-    200: Array<Model>;
+    200: ModelList;
 };
 export type ListModelsResponse = ListModelsResponses[keyof ListModelsResponses];
 export type CreateModelData = {
@@ -5600,14 +6187,35 @@ export type DeclineImageShareResponse = DeclineImageShareResponses[keyof Decline
 export type ListPoliciesData = {
     body?: never;
     path?: never;
-    query?: never;
+    query?: {
+        /**
+         * Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.
+         */
+        cursor?: string;
+        /**
+         * Maximum number of items to return per page. Defaults to 50, clamped to 200.
+         */
+        limit?: number;
+        /**
+         * Sort spec, formatted as `<key>:<direction>`. Allowed values are `createdAt:desc` (default), `createdAt:asc`, `name:asc`, `name:desc`. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        sort?: 'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc';
+        /**
+         * Substring search across `metadata.name`, `metadata.displayName` and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        q?: string;
+        /**
+         * Start from a known pagination boundary. `end` is only supported for `createdAt:desc` listings and returns the oldest page directly without walking every cursor from the first page.
+         */
+        anchor?: 'end';
+    };
     url: '/policies';
 };
 export type ListPoliciesResponses = {
     /**
      * successful operation
      */
-    200: Array<Policy>;
+    200: PolicyList;
 };
 export type ListPoliciesResponse = ListPoliciesResponses[keyof ListPoliciesResponses];
 export type CreatePolicyData = {
@@ -5677,6 +6285,24 @@ export type UpdatePolicyResponses = {
     200: Policy;
 };
 export type UpdatePolicyResponse = UpdatePolicyResponses[keyof UpdatePolicyResponses];
+export type GetPolicyUsagesData = {
+    body?: never;
+    path: {
+        /**
+         * Unique name identifier of the policy
+         */
+        policyName: string;
+    };
+    query?: never;
+    url: '/policies/{policyName}/usages';
+};
+export type GetPolicyUsagesResponses = {
+    /**
+     * successful operation
+     */
+    200: PolicyUsages;
+};
+export type GetPolicyUsagesResponse = GetPolicyUsagesResponses[keyof GetPolicyUsagesResponses];
 export type ListPublicIpsData = {
     body?: never;
     path?: never;
@@ -5711,7 +6337,32 @@ export type ListSandboxHubDefinitionsResponse = ListSandboxHubDefinitionsRespons
 export type ListSandboxesData = {
     body?: never;
     path?: never;
-    query?: never;
+    query?: {
+        /**
+         * If true, include terminated sandboxes in the response. Defaults to false.
+         */
+        showTerminated?: boolean;
+        /**
+         * Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.
+         */
+        cursor?: string;
+        /**
+         * Maximum number of items to return per page. Defaults to 50, clamped to 200.
+         */
+        limit?: number;
+        /**
+         * Sort spec, formatted as `<key>:<direction>`. Allowed values are `createdAt:desc` (default), `createdAt:asc`, `name:asc`, `name:desc`. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        sort?: 'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc';
+        /**
+         * Substring search across `metadata.name`, `metadata.displayName` and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        q?: string;
+        /**
+         * Start from a known pagination boundary. `end` is only supported for `createdAt:desc` listings and returns the oldest page directly without walking every cursor from the first page.
+         */
+        anchor?: 'end';
+    };
     url: '/sandboxes';
 };
 export type ListSandboxesErrors = {
@@ -5733,7 +6384,7 @@ export type ListSandboxesResponses = {
     /**
      * successful operation
      */
-    200: Array<Sandbox>;
+    200: SandboxList;
 };
 export type ListSandboxesResponse = ListSandboxesResponses[keyof ListSandboxesResponses];
 export type CreateSandboxData = {
@@ -5923,7 +6574,12 @@ export type CreateSandboxPreviewData = {
          */
         sandboxName: string;
     };
-    query?: never;
+    query?: {
+        /**
+         * Force creation by deleting conflicting previews that use the same custom domain prefix URL
+         */
+        force?: boolean;
+    };
     url: '/sandboxes/{sandboxName}/previews';
 };
 export type CreateSandboxPreviewResponses = {
@@ -6572,7 +7228,28 @@ export type DeleteVolumeTemplateVersionResponse = DeleteVolumeTemplateVersionRes
 export type ListVolumesData = {
     body?: never;
     path?: never;
-    query?: never;
+    query?: {
+        /**
+         * Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.
+         */
+        cursor?: string;
+        /**
+         * Maximum number of items to return per page. Defaults to 50, clamped to 200.
+         */
+        limit?: number;
+        /**
+         * Sort spec, formatted as `<key>:<direction>`. Allowed values are `createdAt:desc` (default), `createdAt:asc`, `name:asc`, `name:desc`. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        sort?: 'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc';
+        /**
+         * Substring search across `metadata.name`, `metadata.displayName` and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.
+         */
+        q?: string;
+        /**
+         * Start from a known pagination boundary. `end` is only supported for `createdAt:desc` listings and returns the oldest page directly without walking every cursor from the first page.
+         */
+        anchor?: 'end';
+    };
     url: '/volumes';
 };
 export type ListVolumesErrors = {
@@ -6594,7 +7271,7 @@ export type ListVolumesResponses = {
     /**
      * successful operation
      */
-    200: Array<Volume>;
+    200: VolumeList;
 };
 export type ListVolumesResponse = ListVolumesResponses[keyof ListVolumesResponses];
 export type CreateVolumeData = {
@@ -7018,7 +7695,12 @@ export type GetWorkspaceData = {
          */
         workspaceName: string;
     };
-    query?: never;
+    query?: {
+        /**
+         * When true, the response includes a resourceCounts map with the number of agents, functions, models, sandboxes, policies, jobs, volumes, volumetemplates, integrationconnections, previews, customdomains, serviceaccounts and images currently in this workspace. Off by default — each count is one extra indexed query.
+         */
+        countResources?: boolean;
+    };
     url: '/workspaces/{workspaceName}';
 };
 export type GetWorkspaceErrors = {