> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workloads/workspaces/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/run-ai/_mcp/server.

# Workspaces

A Workspace is a simplified tool for researchers to conduct experiments, build AI models, access standard MLOps tools, and collaborate with their peers.
Workspaces abstract complex concepts related to running containerized workloads in a Kubernetes environment and are built from predefined setups that include
networking, storage, secrets and other resources. All the setup and configurations for research, including container 
images, data sets, resource requests, as well as all tools are included. for the research, in a single place. 
It answers the research needs while ensuring infrastructure owners keep control and allocation efficiency.
A workspace is associated with a specific NVIDIA Run:ai project and you can have multiple workspaces under a specific project. 
For more information, see [Workspaces](/run-ai/self-hosted/documentation/workloads-in-nvidia-run-ai/using-workspaces/running-workspace).


## API Docs

- Workspaces [Create a workspace.](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workloads/workspaces/create-workspace-1.md)
- Workspaces [Get workspace data.](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workloads/workspaces/get-workspace.md)
- Workspaces [Delete a workspace.](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workloads/workspaces/delete-workspace.md)
- Workspaces [Suspend a workspace.](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workloads/workspaces/suspend-workspace.md)
- Workspaces [Resume a workspace.](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workloads/workspaces/resume-workspace.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workloads/workspaces/openapi.json)
- [OpenAPI YAML](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workloads/workspaces/openapi.yaml)