Tenants

Deprecated

List Workspaces Endpoint

get

Endpoint to list workspaces.

Only superusers can list all workspaces, without membership.

Args: tenant_id: Deprecated, use workspace_id instead. tenant_name: Deprecated, use workspace_name instead. workspace_id: Workspace ID to filter by. workspace_name: Workspace name to filter by. url: Workspace service URL to filter by. organization_id: Organization ID to filter by. status: Filter by workspace status. is_managed: Filter by whether the workspace is managed by ZenML Pro. owner_id: Id of the Workspace owner offset: Offset for pagination. limit: Limit for pagination. auth_context: Auth context. workspace_manager: Workspace manager. organization_manager: Organization manager. rbac: RBAC component.

Returns: List of all workspaces within the given filter params.

Raises: IllegalOperationError: If the operation is not allowed.

Authorizations

OAuth2ComboScheme

OAuth2clientCredentialsRequired

Token URL:

---

OAuth2authorizationCodeRequired

Authorization URL: Token URL: Refresh URL:

Query parameters

tenant_idany ofOptional

string · uuidOptional

or

nullOptional

tenant_nameany ofOptional

stringOptional

or

nullOptional

workspace_idany ofOptional

string · uuidOptional

or

nullOptional

workspace_nameany ofOptional

stringOptional

or

nullOptional

urlany ofOptional

stringOptional

or

nullOptional

organization_idany ofOptional

string · uuidOptional

or

nullOptional

statusany ofOptional

string · enumOptional

Enum that represents the desired state or status of a workspace.

These values can be used in two places:

• in the desired_state field of a workspace object, to indicate the desired state of the workspace (with the exception of PENDING and FAILED which are not valid values for desired_state)
• in the status field of a workspace object, to indicate the current state of the workspace

Possible values:

or

nullOptional

is_managedany ofOptional

booleanOptional

or

nullOptional

owner_idany ofOptional

string · uuidOptional

or

nullOptional

offsetintegerOptionalDefault: 0

limitinteger · max: 100OptionalDefault: 100

Responses

200

Successful Response

application/json

Pydantic Model for viewing a workspace.

idstring · uuidRequired

namestring · min: 1 · max: 50Required

The name of the workspace.

display_namestring · min: 1 · max: 50Required

The display name of the workspace.

descriptionany ofOptional

The description of the workspace.

string · min: 1 · max: 256Optional

or

nullOptional

logo_urlany ofOptional

The logo URL of the workspace.

stringOptional

or

nullOptional

is_managedbooleanOptional

Whether the workspace is managed by ZenML Pro or managed externally and enrolled.

Default: true

enrollment_keyany ofOptional

Credentials generated for enrolled workspaces. Only set for enrolled workspaces and only during the enrollment process.

stringOptional

or

nullOptional

desired_statestring · enumRequired

The desired state of the workspace.

Possible values:

state_reasonstring · enumRequired

The reason for the current workspace state.

Possible values:

statusstring · enumRequired

The current operational state of the workspace.

Possible values:

createdstring · date-timeRequired

updatedstring · date-timeRequired

status_updatedany ofOptional

The time the status was last updated.

string · date-timeOptional

or

nullOptional

422

Validation Error

application/json

get

/tenants

HTTPcURLJavaScriptPython

GET /tenants HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "display_name": "text",
    "description": "text",
    "logo_url": "text",
    "organization": {
      "name": "text",
      "description": "text",
      "logo_url": "text",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created": "2026-04-02T14:28:14.753Z",
      "updated": "2026-04-02T14:28:14.753Z",
      "owner": {
        "password": "text",
        "password_expired": true,
        "name": "text",
        "avatar_url": "text",
        "company": "text",
        "job_title": "text",
        "metadata": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "username": "text",
        "email": "text",
        "oauth_provider": "text",
        "oauth_id": "text",
        "is_active": true,
        "is_superuser": false,
        "is_service_account": false,
        "organization_id": "123e4567-e89b-12d3-a456-426614174000",
        "is_onboarded": false
      },
      "links": [
        {
          "label": "text",
          "url": "text"
        }
      ],
      "has_active_subscription": true,
      "trial_expiry": 1
    },
    "owner": {
      "password": "text",
      "password_expired": true,
      "name": "text",
      "avatar_url": "text",
      "company": "text",
      "job_title": "text",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "username": "text",
      "email": "text",
      "oauth_provider": "text",
      "oauth_id": "text",
      "is_active": true,
      "is_superuser": false,
      "is_service_account": false,
      "organization_id": "123e4567-e89b-12d3-a456-426614174000",
      "is_onboarded": false
    },
    "is_managed": true,
    "enrollment_key": "text",
    "zenml_service": {
      "configuration": {
        "version": "text",
        "analytics_enabled": true,
        "secrets_store": {
          "type": "sql"
        },
        "backup_secrets_store": {
          "type": "sql"
        },
        "admin": {
          "helm_chart_version": "text",
          "image_repository": "text",
          "image_tag": "text",
          "debug": true,
          "rbac_implementation_source": "text",
          "workload_manager_implementation_source": "text",
          "feature_gate_implementation_source": "text",
          "environment_vars": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "secret_environment_vars": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "provider_type": "argocd",
          "provider_config": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "service_tier": "basic",
          "resources": {
            "replicas": 1,
            "cpu": "text",
            "memory": "text",
            "max_cpu": "text",
            "max_memory": "text",
            "memory_migration": "text",
            "max_memory_migration": "text",
            "autoscaling_enabled": false,
            "min_replicas": 1,
            "max_replicas": 1,
            "thread_pool_size": 40,
            "db_pool_size": 20,
            "db_pool_overflow": 20,
            "workspace_node_pool": "main",
            "workload_node_pool": "main",
            "max_concurrent_template_runs": 1,
            "memory_run_template": "text",
            "max_memory_run_template": "text",
            "max_storage_size": 1073741824
          }
        }
      },
      "status": {
        "server_url": "text",
        "version": "text",
        "storage_size": 1,
        "storage_size_last_updated": "2026-04-02T14:28:14.753Z",
        "storage_access_blocked": false
      }
    },
    "usage_counts": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "desired_state": "not_initialized",
    "state_reason": "user_action",
    "status": "not_initialized",
    "created": "2026-04-02T14:28:14.753Z",
    "updated": "2026-04-02T14:28:14.753Z",
    "status_updated": "2026-04-02T14:28:14.753Z"
  }
]

Deprecated

Create Workspace Endpoint

post

Create or enroll a workspace.

Args: workspace_create: Workspace create model. organization_id: ID of the organization to which the workspace belongs to. force: If it should be created regardless of workspace limits. enroll: Set if this is an unmanaged workspace that is being enrolled. name: Name of the workspace. description: Description of the workspace. rbac: RBAC component. auth_context: Auth context. workspace_manager: Workspace manager. organization_manager: Organization manager.

Returns: Model of the created workspace.

Raises: IllegalOperationError: If the operation is not allowed.

Authorizations

OAuth2ComboScheme

OAuth2clientCredentialsRequired

Token URL:

---

OAuth2authorizationCodeRequired

Authorization URL: Token URL: Refresh URL:

Query parameters

organization_idany ofOptional

string · uuidOptional

or

nullOptional

nameany ofOptional

stringOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

forcebooleanOptionalDefault: false

enrollbooleanOptionalDefault: false

Body

application/json

or

nullOptional

Responses

200

Successful Response

application/json

Pydantic Model for viewing a workspace.

idstring · uuidRequired

namestring · min: 1 · max: 50Required

The name of the workspace.

display_namestring · min: 1 · max: 50Required

The display name of the workspace.

descriptionany ofOptional

The description of the workspace.

string · min: 1 · max: 256Optional

or

nullOptional

logo_urlany ofOptional

The logo URL of the workspace.

stringOptional

or

nullOptional

is_managedbooleanOptional

Whether the workspace is managed by ZenML Pro or managed externally and enrolled.

Default: true

enrollment_keyany ofOptional

Credentials generated for enrolled workspaces. Only set for enrolled workspaces and only during the enrollment process.

stringOptional

or

nullOptional

desired_statestring · enumRequired

The desired state of the workspace.

Possible values:

state_reasonstring · enumRequired

The reason for the current workspace state.

Possible values:

statusstring · enumRequired

The current operational state of the workspace.

Possible values:

createdstring · date-timeRequired

updatedstring · date-timeRequired

status_updatedany ofOptional

The time the status was last updated.

string · date-timeOptional

or

nullOptional

422

Validation Error

application/json

post

/tenants

HTTPcURLJavaScriptPython

POST /tenants HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1466

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "display_name": "text",
  "description": "text",
  "logo_url": "text",
  "owner_id": "123e4567-e89b-12d3-a456-426614174000",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "is_managed": true,
  "enrollment_key": "text",
  "zenml_service": {
    "configuration": {
      "version": "text",
      "analytics_enabled": true,
      "secrets_store": {
        "type": "sql"
      },
      "backup_secrets_store": {
        "type": "sql"
      },
      "admin": {
        "helm_chart_version": "text",
        "image_repository": "text",
        "image_tag": "text",
        "debug": true,
        "rbac_implementation_source": "text",
        "workload_manager_implementation_source": "text",
        "feature_gate_implementation_source": "text",
        "environment_vars": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "secret_environment_vars": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "provider_type": "argocd",
        "provider_config": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "service_tier": "basic",
        "resources": {
          "replicas": 1,
          "cpu": "text",
          "memory": "text",
          "max_cpu": "text",
          "max_memory": "text",
          "memory_migration": "text",
          "max_memory_migration": "text",
          "autoscaling_enabled": false,
          "min_replicas": 1,
          "max_replicas": 1,
          "thread_pool_size": 40,
          "db_pool_size": 20,
          "db_pool_overflow": 20,
          "workspace_node_pool": "main",
          "workload_node_pool": "main",
          "max_concurrent_template_runs": 1,
          "memory_run_template": "text",
          "max_memory_run_template": "text",
          "max_storage_size": 1073741824
        }
      }
    },
    "status": {
      "server_url": "text",
      "version": "text",
      "storage_size": 1,
      "storage_size_last_updated": "2026-04-02T14:28:14.753Z",
      "storage_access_blocked": false
    }
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "display_name": "text",
  "description": "text",
  "logo_url": "text",
  "organization": {
    "name": "text",
    "description": "text",
    "logo_url": "text",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "created": "2026-04-02T14:28:14.753Z",
    "updated": "2026-04-02T14:28:14.753Z",
    "owner": {
      "password": "text",
      "password_expired": true,
      "name": "text",
      "avatar_url": "text",
      "company": "text",
      "job_title": "text",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "username": "text",
      "email": "text",
      "oauth_provider": "text",
      "oauth_id": "text",
      "is_active": true,
      "is_superuser": false,
      "is_service_account": false,
      "organization_id": "123e4567-e89b-12d3-a456-426614174000",
      "is_onboarded": false
    },
    "links": [
      {
        "label": "text",
        "url": "text"
      }
    ],
    "has_active_subscription": true,
    "trial_expiry": 1
  },
  "owner": {
    "password": "text",
    "password_expired": true,
    "name": "text",
    "avatar_url": "text",
    "company": "text",
    "job_title": "text",
    "metadata": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "username": "text",
    "email": "text",
    "oauth_provider": "text",
    "oauth_id": "text",
    "is_active": true,
    "is_superuser": false,
    "is_service_account": false,
    "organization_id": "123e4567-e89b-12d3-a456-426614174000",
    "is_onboarded": false
  },
  "is_managed": true,
  "enrollment_key": "text",
  "zenml_service": {
    "configuration": {
      "version": "text",
      "analytics_enabled": true,
      "secrets_store": {
        "type": "sql"
      },
      "backup_secrets_store": {
        "type": "sql"
      },
      "admin": {
        "helm_chart_version": "text",
        "image_repository": "text",
        "image_tag": "text",
        "debug": true,
        "rbac_implementation_source": "text",
        "workload_manager_implementation_source": "text",
        "feature_gate_implementation_source": "text",
        "environment_vars": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "secret_environment_vars": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "provider_type": "argocd",
        "provider_config": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "service_tier": "basic",
        "resources": {
          "replicas": 1,
          "cpu": "text",
          "memory": "text",
          "max_cpu": "text",
          "max_memory": "text",
          "memory_migration": "text",
          "max_memory_migration": "text",
          "autoscaling_enabled": false,
          "min_replicas": 1,
          "max_replicas": 1,
          "thread_pool_size": 40,
          "db_pool_size": 20,
          "db_pool_overflow": 20,
          "workspace_node_pool": "main",
          "workload_node_pool": "main",
          "max_concurrent_template_runs": 1,
          "memory_run_template": "text",
          "max_memory_run_template": "text",
          "max_storage_size": 1073741824
        }
      }
    },
    "status": {
      "server_url": "text",
      "version": "text",
      "storage_size": 1,
      "storage_size_last_updated": "2026-04-02T14:28:14.753Z",
      "storage_access_blocked": false
    }
  },
  "usage_counts": {
    "ANY_ADDITIONAL_PROPERTY": 1
  },
  "desired_state": "not_initialized",
  "state_reason": "user_action",
  "status": "not_initialized",
  "created": "2026-04-02T14:28:14.753Z",
  "updated": "2026-04-02T14:28:14.753Z",
  "status_updated": "2026-04-02T14:28:14.753Z"
}

Deprecated

Delete All Workspaces Endpoint

delete

Delete all workspaces.

Args: user: Authenticated user. workspace_manager: Workspace manager.

Raises: IllegalOperationError: If a regular user tries to force delete or if the operation is not allowed in the current environment.

Authorizations

OAuth2ComboScheme

OAuth2clientCredentialsRequired

Token URL:

---

OAuth2authorizationCodeRequired

Authorization URL: Token URL: Refresh URL:

Responses

200

Successful Response

application/json

anyOptional

delete

/tenants

HTTPcURLJavaScriptPython

DELETE /tenants HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

Successful Response

No content