Drives
Create Drive
Create a new drive (authenticated users only). For agents, use POST /v0/drives/provision instead.
POST
Request Body
string
required
The name of the drive.
string
An optional description for the drive.
Response
string
Unique identifier for the drive.
string
The name of the drive.
string
Human-readable identifier (
username/drive-name).string
The description of the drive.
integer
The number of files in the drive (always 0 on creation).
integer
Total size of all files in the drive, in bytes (always 0 on creation).
string
ISO 8601 timestamp of when the drive was created.
string
ISO 8601 timestamp of when the drive was last updated.
Notes
- Requires authentication. Agents without an account should use
POST /v0/drives/provisioninstead. - A slug is auto-generated from your username and the drive name.
