Get Volume

Retrieve detailed information about a specific volume.

Endpoint

GET /{envId}/volume/{id}

Authentication

Required: Yes (Session or Bearer Token with 2FA)

Path Parameters

Parameter	Type	Required	Description
envId	string (UUID)	Yes	Environment ID containing the volume
id	string (UUID)	Yes	Volume ID

Response

Success Response (200 OK)

{
  "id": "vol-550e8400-e29b-41d4-a716-446655440000",
  "name": "postgres-data",
  "envIdRef": "660e8400-e29b-41d4-a716-446655440001",
  "companyIdRef": "770e8400-e29b-41d4-a716-446655440002",
  "size": 10240,
  "mountPath": "/var/lib/postgresql/data",
  "isDeleted": false,
  "createdBy": "user-123",
  "modifiedBy": "user-456",
  "version": 2
}

Error Responses

Status Code	Description
400	Bad Request - Invalid UUID format
401	Unauthorized - Invalid or missing authentication
403	Forbidden - User doesn't have access to this volume
404	Not Found - Volume or environment doesn't exist
500	Internal Server Error

Examples

curl -X GET "https://api.thevenin.cloud/environments/{envId}/volume/{volumeId}" \
  -H "Authorization: Bearer tvn_your_api_token_here"

• Both environment ID and volume ID must be valid UUIDs