> ## Documentation Index > Fetch the complete documentation index at: https://docs.langchain.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a volume (Beta) > **Beta:** This API is in active development and may change without notice. Requires sandbox volumes to be enabled for your workspace. Create an empty volume that can be attached to sandboxes at a mount path. The size is rounded up to a whole GiB. ## OpenAPI ````yaml /langsmith/langsmith-platform-openapi.json post /api/v2/sandboxes/volumes openapi: 3.1.0 info: title: LangSmith description: >+ The LangSmith API is used to programmatically create and manage LangSmith resources. ## Host https://api.smith.langchain.com ## Authentication To authenticate with the LangSmith API, set the `X-Api-Key` header to a valid [LangSmith API key](https://docs.langchain.com/langsmith/create-account-api-key#create-an-api-key). version: 0.1.0 servers: - url: / security: [] tags: - name: run x-group: Tracing - name: runs x-group: Tracing - name: sessions x-group: Tracing - name: tracer-sessions x-group: Tracing - name: threads x-group: Threads - name: datasets x-group: Datasets - name: examples x-group: Datasets - name: evaluators x-group: Evaluation - name: experiment-view-overrides x-group: Evaluation - name: experiments x-group: Evaluation - name: annotation-queues x-group: Feedback & Annotation - name: annotation_queues x-group: Feedback & Annotation - name: feedback x-group: Feedback & Annotation - name: feedback-configs x-group: Feedback & Annotation - name: alert_rules x-group: Monitoring - name: bulk-exports x-group: Monitoring - name: charts x-group: Monitoring - name: commits x-group: Prompts & Playground - name: directories x-group: Prompts & Playground - name: hub_environments x-group: Prompts & Playground - name: playground-settings x-group: Prompts & Playground - name: prompt-webhooks x-group: Prompts & Playground - name: prompts x-group: Prompts & Playground - name: tag-transitions x-group: Prompts & Playground - name: comments x-group: Prompt Hub - name: likes x-group: Prompt Hub - name: optimization-jobs x-group: Prompt Hub - name: ownerships x-group: Prompt Hub - name: repos x-group: Prompt Hub - name: settings x-group: Prompt Hub - name: tags x-group: Prompt Hub - name: integrations x-group: Integrations & Tools - name: mcp x-group: Integrations & Tools - name: mcp_vendors x-group: Integrations & Tools - name: oauth x-group: Integrations & Tools - name: tools x-group: Integrations & Tools - name: gateway-policies x-group: LLM Gateway - name: sandboxes x-group: Sandboxes - name: issues x-group: Issues - name: issues-agent x-group: Issues - name: Organizations x-group: Administration - name: SCIM Tokens x-group: Administration - name: TTL Settings x-group: Administration - name: access_policies x-group: Administration - name: api-key x-group: Administration - name: audit-logs x-group: Administration - name: auth x-group: Administration - name: aws_marketplace x-group: Administration - name: data_planes x-group: Administration - name: me x-group: Administration - name: orgs x-group: Administration - name: service-accounts x-group: Administration - name: tenant x-group: Administration - name: ttl-settings x-group: Administration - name: usage-limits x-group: Administration - name: workspaces x-group: Administration - name: ace x-group: System - name: backfills x-group: System - name: features x-group: System - name: info x-group: System - name: model-price-map x-group: System - name: public x-group: System - name: agents x-hidden: true - name: fleet orgs - name: fleet secrets - name: fleet tenants - name: fleet threads x-hidden: true - name: fleet users - name: productfeedback x-hidden: true - name: usage paths: /api/v2/sandboxes/volumes: post: tags: - sandboxes summary: Create a volume (Beta) description: >- **Beta:** This API is in active development and may change without notice. Requires sandbox volumes to be enabled for your workspace. Create an empty volume that can be attached to sandboxes at a mount path. The size is rounded up to a whole GiB. parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/sandboxes.CreateVolumePayload' responses: '201': description: Created headers: Location: description: URL of the new volume schema: type: string content: application/json: schema: $ref: '#/components/schemas/sandboxes.VolumeResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/sandboxes.ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/sandboxes.ErrorResponse' '409': description: a volume with this name exists content: application/json: schema: $ref: '#/components/schemas/sandboxes.ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/sandboxes.ErrorResponse' security: - API Key: [] - Tenant ID: [] - Bearer Auth: [] components: schemas: sandboxes.CreateVolumePayload: type: object required: - name - size_bytes properties: description: type: string maxLength: 1024 labels: $ref: '#/components/schemas/sandboxes.Labels' name: description: Name is unique within the workspace. type: string maxLength: 255 size_bytes: description: SizeBytes is the volume's capacity, rounded up to a whole GiB. type: integer sandboxes.VolumeResponse: type: object properties: attachments: type: array items: $ref: '#/components/schemas/sandboxes.VolumeAttachmentResponse' created_at: type: string format: date-time created_by: type: string description: type: string id: type: string labels: $ref: '#/components/schemas/sandboxes.Labels' name: type: string size_bytes: type: integer source_volume_id: type: string status: type: string status_message: type: string updated_at: type: string format: date-time updated_by: type: string sandboxes.ErrorResponse: type: object properties: detail: type: object properties: error: type: string error_id: type: string message: type: string sandboxes.Labels: type: object additionalProperties: type: string sandboxes.VolumeAttachmentResponse: type: object properties: mount_path: type: string read_only: type: boolean sandbox_id: type: string sandbox_name: type: string securitySchemes: API Key: type: apiKey in: header name: X-API-Key Tenant ID: type: apiKey in: header name: X-Tenant-Id Bearer Auth: type: http description: >- Bearer tokens are used to authenticate from the UI. Must also specify x-tenant-id or x-organization-id (for org scoped apis). scheme: bearer ````