Skip to main content
Get detailed information about a specific volume by its name.

Path parameters

name
string
required
The name of the volume to retrieve

Response

id
string
Unique identifier for the volume
name
string
Volume name
size
integer
Volume size in GB
state
string
Current state: creating, ready, deleting, deleted, error
organizationId
string
ID of the organization that owns the volume
createdAt
string
ISO 8601 timestamp of volume creation
deletedAt
string
ISO 8601 timestamp of volume deletion (only present if deleted)

Example request

curl https://api.daytona.io/volumes/by-name/my-data-volume \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "id": "vol_abc123xyz",
  "name": "my-data-volume",
  "size": 50,
  "state": "ready",
  "organizationId": "org_123",
  "createdAt": "2024-01-15T10:30:00Z"
}

Error responses

404
Volume not found with the specified name
{
  "statusCode": 404,
  "message": "Volume not found",
  "error": "Not Found"
}

Build docs developers (and LLMs) love