> 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/workload-assets/environment/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/run-ai/_mcp/server.

# Environment

An environment resource designates the container image, the image pull policy, working directory, security parameters, and others. 
It exposes all the necessary tools (open source, 3rd party, or custom tools) along 
with their connection interfaces including external node port and the container ports.
You can also specify a standard, distributed, or inference workload architecture for the environment.
An environment is a mandatory building block for the creation of a workload.
For more information, see [Environments](/run-ai/self-hosted/documentation/workloads-in-nvidia-run-ai/assets/environments).


## API Docs

- Environment [List environment assets.](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workload-assets/environment/list-environment-assets.md)
- Environment [Create an environment asset.](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workload-assets/environment/create-environment-asset.md)
- Environment [Get an environment asset.](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workload-assets/environment/get-environment-asset-by-id.md)
- Environment [Update an environment asset.](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workload-assets/environment/update-environment-asset-by-id.md)
- Environment [Delete an environment asset.](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workload-assets/environment/delete-environment-asset-by-id.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/workload-assets/environment/openapi.json)
- [OpenAPI YAML](https://docs.nvidia.com/run-ai/self-hosted/v3.0/reference/rest-api/endpoints/workload-assets/environment/openapi.yaml)