> ## Documentation Index > Fetch the complete documentation index at: https://docs.e2b.dev/llms.txt > Use this file to discover all available pages before exploring further. # Create team volume > Create a new team volume ## OpenAPI ````yaml /openapi-public.yaml post /volumes openapi: 3.1.0 info: title: E2B API version: 0.1.0 description: >- Complete E2B developer API. Platform endpoints are served on api.e2b.app. Sandbox endpoints (envd) are served on the shared sandbox host (sandbox.e2b.app); target a specific sandbox with the E2b-Sandbox-Id and E2b-Sandbox-Port headers. servers: - url: https://api.e2b.app description: E2B Platform API security: [] tags: - name: Sandboxes - name: Templates - name: Tags - name: Volumes - name: Envd - name: Filesystem - name: Process - name: Teams - name: Secrets - name: Events - name: Webhooks paths: /volumes: servers: - url: https://api.e2b.app description: E2B Platform API post: tags: - Volumes summary: Create team volume description: Create a new team volume operationId: postVolumes requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/NewVolume' responses: '201': description: Successfully created a new team volume content: application/json: schema: $ref: '#/components/schemas/VolumeAndToken' '400': description: Bad request content: application/json: schema: required: - code - message properties: code: type: integer format: int32 description: Error code example: 400 error_code: type: string description: >- Machine-readable semantic error code. Not a closed set; initial values: sandbox_capacity_unavailable, sandbox_placement_timeout, sandbox_no_compatible_node, sandbox_create_failed, internal_server_error. message: type: string description: Error type: object examples: volumeNameExists: summary: A volume with this name already exists value: code: 400 message: Volume with name 'my-volume' already exists '401': description: Authentication error content: application/json: schema: required: - code - message properties: code: type: integer format: int32 description: Error code example: 401 error_code: type: string description: >- Machine-readable semantic error code. Not a closed set; initial values: sandbox_capacity_unavailable, sandbox_placement_timeout, sandbox_no_compatible_node, sandbox_create_failed, internal_server_error. message: type: string description: Error type: object examples: missingAuthentication: summary: No supported authentication header was supplied value: code: 401 message: authorization header is missing '403': description: Forbidden content: application/json: schema: required: - code - message properties: code: type: integer format: int32 description: Error code example: 403 error_code: type: string description: >- Machine-readable semantic error code. Not a closed set; initial values: sandbox_capacity_unavailable, sandbox_placement_timeout, sandbox_no_compatible_node, sandbox_create_failed, internal_server_error. message: type: string description: Error type: object examples: teamBanned: summary: The team is banned at authentication value: code: 403 message: team is banned teamBlocked: summary: >- The authenticated team is blocked. The message may append a reason value: code: 403 message: team is blocked volumesDisabled: summary: Volumes are not enabled for this team value: code: 403 message: use of volumes is not enabled '429': description: Too many requests headers: Retry-After: description: >- When present, the number of seconds to wait before retrying the request. required: false schema: type: integer minimum: 0 example: 30 RateLimit-Limit: description: Configured rate-limit burst size. schema: type: integer RateLimit-Remaining: description: Requests remaining in the rate-limit window. schema: type: integer RateLimit-Reset: description: Seconds until the rate-limit window resets. schema: type: integer content: application/json: schema: required: - code - message properties: code: type: integer format: int32 description: Error code example: 429 error_code: type: string description: >- Machine-readable semantic error code. Not a closed set; initial values: sandbox_capacity_unavailable, sandbox_placement_timeout, sandbox_no_compatible_node, sandbox_create_failed, internal_server_error. message: type: string description: Error type: object examples: rateLimitExceeded: summary: A configured API rate limit was exceeded value: code: 429 message: Rate limit exceeded '500': description: Server error content: application/json: schema: required: - code - message properties: code: type: integer format: int32 description: Error code example: 500 error_code: type: string description: >- Machine-readable semantic error code. Not a closed set; initial values: sandbox_capacity_unavailable, sandbox_placement_timeout, sandbox_no_compatible_node, sandbox_create_failed, internal_server_error. message: type: string description: Error type: object examples: operationFailed: summary: The deployment has no default volume type value: code: 500 message: No persistent volume type is configured '501': description: Not implemented by this deployment content: application/json: schema: required: - code - message properties: code: type: integer format: int32 description: Error code example: 501 error_code: type: string description: >- Machine-readable semantic error code. Not a closed set; initial values: sandbox_capacity_unavailable, sandbox_placement_timeout, sandbox_no_compatible_node, sandbox_create_failed, internal_server_error. message: type: string description: Error type: object examples: volumeSigningUnavailable: summary: >- The deployment has no volume content-token signing configuration value: code: 501 message: >- volumes content token signing is not supported by this deployment '503': description: Service unavailable content: application/json: schema: required: - code - message properties: code: type: integer format: int32 description: Error code example: 503 error_code: type: string description: >- Machine-readable semantic error code. Not a closed set; initial values: sandbox_capacity_unavailable, sandbox_placement_timeout, sandbox_no_compatible_node, sandbox_create_failed, internal_server_error. message: type: string description: Error type: object examples: clusterNotFound: summary: The team's cluster could not be resolved value: code: 503 message: Cluster not found security: - ApiKeyAuth: [] components: schemas: NewVolume: type: object properties: name: type: string description: Name of the volume pattern: ^[a-zA-Z0-9_-]+$ required: - name VolumeAndToken: type: object properties: volumeID: type: string description: ID of the volume name: type: string description: Name of the volume token: type: string description: Auth token to use for interacting with volume content domain: type: string description: | Domain to use as the destination for volume content requests, replacing the default `api.`. Only returned when the team is connected to a custom (BYOC) cluster; absent otherwise, in which case the default domain is used. required: - volumeID - name - token securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ````